INTRODUCTION TO EPROMS 


What i s a EPROM? 
How do y o u p r o g r a m them? 
Why w o u l d y o u want t o 
program an EPROM? 
Once i t i s programmed what do y o u do w i t h 
i t ? 
D u r i n g t h e c o u r s e o f t h i s manual we w i l l answer t h e s e 
and 
o t h e r 
q u e s t i o n s a b o u t EPROMs. 


O f a l l t h e v a r i o u s f a c e t s o f home c o m p u t i n g , EPROMs 
a r e 
one 
of 
t h e l e a s t u n d e r s t o o d and t h e most u s e f u l . V e r y l i t t l e i s known by 
t h e a v e r a g e u s e r a b o u t EPROMs o r how t o u s e them. Many p e o p l e a r e 
a f r a i d o f o p e n i n g up t h e i r computers, d i s k d r i v e s and c a r t r i d g e s . 
They d o n ' t r e a l l y know what t h e y a r e l o o k i n g a t , 
how 
t h e 
c h i p s 
work o r what t h e y do. Yet, when a u s e r b e g i n s t o 
u n d e r s t a n d 
t h e 
power and v e r s a t i l i t y o f EPROMs, one becomes hooked. 
A 
t y p e 
o f 
a d d i c t i o n soon t a k e s o v e r 
t h e 
u s e r ; 
b e f o r e 
l o n g 
y o u ' l l 
f i n d 
y o u r s e l f w a n t i n g t o p u t a l l o f y o u r f a v o r i t e programs on EPROM. 


Programs, once p u t on an EPROM, 
r e q u i r e v i r t u a l l y no t i m e a t 
a l l 
t o l o a d . I m a g i n e t u r n i n g on y o u r computer 
and 
i n s t a n t l y 
h a v i n g 
y o u r f a v o r i t e word p r o c e s s o r , d a t a base, s p r e a d s h e e t 
o r 
u t i l i t y 
up and r u n n i n g . J u s t b y p l u g g i n g i n a c a r t r i d g e 
and 
t u r n i n g 
on 
y o u r computer y o u c a n be r e a d y t o 
g e t 
t o w o r k ! 
No 
l o n g 
LOAD 
t i m e s , what used t o t a k e m i n u t e s 
t o 
l o a d 
may 
r e q u i r e 
o n l y 
a 
f r a c t i o n o f a second f r o m a 
c a r t r i d g e . 
N o t 
o n l y 
t h a t , 
i t i s 


p o s s i b l e t o p u t many d i f f e r e n t programs on a s i n g l e c a r t r i d g e and 
p i c k y o u r f a v o r i t e f r o m a menu. L e t ' s t a k e a q u i c k l o o k 
a t 
some 
o f t h e d i f f e r e n t p o s s i b i l i t i e s t h a t t h e use o f 
EPROMs 
b r i n g 
t o 
mind: 


1. P u t t i n g a s i n g l e p r o g r a m on a c a r t r i d g e 


2. P u t t i n g a number o f d i f f e r e n t programs on a 
s i n g l e 
c a r t r i d g e 
w i t h a menu t h a t a l l o w s y o u t o s e l e c t t h e d e s i r e d one. 


3. U s i n g BANK SWITCHED c a r t r i d g e s t h a t a l l o w y o u t o p u t 
256K 
of 
memory on a s i n g l e b o a r d . T h i n k o f a l l 
t h e 
v a r i o u s 
programs 
t h a t y o u w i l l f i t i n 256K!! You c a n add a menu t h a t a l l o w s y o u 
t o p i c k and choose programs a t w i l l . 


4. M o d i f y i n g t h e KERNAL o r BASIC ROM o f t h e computer so t h a t 
y o u 
have y o u r own t o t a l l y c u s t o m i z e d c o m p u t e r . I t i s p o s s i b l e 
t o 
change s c r e e n c o l o r s , 
t i t l e messages 
on 
power-up, 
d e f a u l t 
d e v i c e numbers and much more. 


5. M o d i f y t h e DOS ( D i s k 
O p e r a t i n g 
System) 
f o r 
a 
custom 
d i s k 
d r i v e . E x t r a t r a c k s and 
s e c t o r s , 
h i g h 
speed 
d a t a 
t r a n s f e r 
r o u t i nes. 


6. Use t h e PROMENADE as d e v i c e #16. T h i s a l l o w s y o u LOAD and S A V E 
f i l e s f r o m EPROMs, as y o u w o u l d on y o u r 
d i s k 
d r i v e . 
I m a g i n e 
l o a d i n g y o u r f a v o r i t e p r o g r a m f r o m an EPROM. 


7. Program EPROMs t h a t 
c a n 
be 
used 
i n o t h e r 
computers. 
The 
PROMENADE may be used t o program a w i d e v a r i e t y o f EPROMS. 
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8. C r e a t e y o u r own, t o t a l l y new, o p e r a t i n g system 
f o r 
t h e 
C-64 
( o r o t h e r c o m p u t e r ) and end up w i t h a 
s p e c i a l i z e d , 
d e d i c a t e d 
computer. T h i s i s e x t r e m e l y u s e f u l i n s c i e n t i f i c a p p l i c a t i o n s , 
b u s i n e s s and i n d u s t r i a1 c o n t r o l a p p l i c a t i o n s . 


Now t h a t we have l o o k e d a t some o f t h e a p p l i c a t i o n s l e t ' s examine 
a f e w o f t h e f u n d a m e n t a l s o f EPROMs and EPROM programming. 


L e t ' s s t a r t o f f b y l o o k i n g a t what an EPROM i s and how i t works. 
An EPROM i s a t y p e o f memory c h i p , i 
.e., 
an 
e l e c t r o n i c 
s t o r a g e 
d e v i c e , s i m i l i a r i n n a t u r e t o a d i s k . 
Data, 
programs 
o r 
o t h e r 
t y p e s o f i n f o r m a t i o n can be p u t o n t o an EPROM f o r 
l a t e r 
r e c a l l , 
j u s t as t h e same d a t a may be saved t o a d i s k and l a t e r 
r e c a l l e d . 
D a t a 
may 
be 
e r a s e d 
f r o m 
an 
EPROM 
and 
t h e 
EPROM 
may 
be 
reprogrammed, s i m i l i a r t o e r a s i n g and c o p y i n g a d i s k . 


EPROMs a r e r e l a t e d t o o t h e r t y p e s o f memory c h i p s 
such 
as 
ROMs 
and PROMs. ROM s t a n d s f o r Read O n l y 
Memory. 
'Read 
o n l y ' 
means 
t h a t we can o n l y r e a d i n f o r m a t i o n 
f r o m 
t h i s 
memory 
c h i p , 
n o t 
w r i t e t o i t . T h a t i s , we can 
examine 
and 
u s e 
t h e 
i n f o r m a t i o n 
c o n t a i n e d i n a ROM, 
b u t 
we 
c a n ' t 
change it. 
ROM 
c h i p s 
come 
pre-programmed d i r e c t l y 
f r o m 
t h e 
m a n u f a c t u r e r 
and 
c a n n o t 
be 
changed o r m o d i f i e d i n any way. Once a R O M i s programmed i t w i l l 
r e t a i n i t s d a t a i n d e f i n i t e l y , w i t h o u t r e q u i r i n g any power 
t o 
do 
so. I n o t h e r words, we may t u r n t h e c o m p u t e r ' s power o f f 
and when 
i t i s t u r n e d back on t h e ROM w i l l have r e t a i n e d a l l t h e d a t a . 


PROM 
s t a n d s 
f o r 
Programmable 
Read 
O n l y 
Memory. 
The 
word 
'Programmable' r e f e r s t o t h e f a c t t h a t t h e u s e r may program 
t h i s 
c h i p . 
T h i s 
programming 
i s a 
o n e - s h o t 
a f f a i r ; 
once i t 
i s 
programmed t h e code may n o t be a l t e r e d o r e r a s e d . I n t h i s 
manner 
t h e PROM i s v e r y c l o s e l y r e l a t e d t o t h e ROM. 
L i k e 
t h e 
R O M y 
t h e 
PROM does n o t r e q u i r e any power i n o r d e r t o r e t a i n i t s d a t a . 


N e x t we have t h e EPROM, E r a s e a b l e Programmable Read O n l y 
Memory. 
The EPROM may be programmed and e r a s e d t h o u s a n d s 
o f 
t i m e s . 
The 
EPROM w i l l p e r f o r m i d e n t i c a l l y t o a R O M when i t i s i n s t a l l e d i n a 
c i r c u i t . As b e f o r e , t h e EPROM does n o t r e q u i r e any power i n o r d e r 
t o r e t a i n i t s d a t a . The m a j o r d i f f e r e n c e comes when i t i s t i m e t o 
change o r m o d i f y t h e d a t a c o n t a i n e d on t h e c h i p . W i t h a ROM o r 
a 
PROM i t i s n o t p o s s i b l e t o r e p r o g r a m them, whereas an 
EPROM 
may 
be e r a s e d and re-programmed. One can e a s i l y see t h a t i t i s v e r y 
advantageous t o have a c h i p t h a t may 
be 
r e u s e d 
t i m e 
and 
t i m e 
a g a i n . 


C l o s e l y r e l a t e d t o ROM, 
PROM, 
and EPROM i s t h e 
R A M 
c h i p . 
RAM, 
w h i c h i s Random Access Memory, means t h a t we can r e a d OR w r i t e t o 
any b y t e on t h e c h i p any t i m e we want. A n o t h e r d i f f e r e n c e between 
R A M and ROM i s t h a t t h e c o n t e n t s o f R A M d i s a p p e a r when t h e 
power 
i s removed. ROMs, 
on t h e o t h e r hand, h o l d o n t o t h e i r d a t a w i t h o u t 
n e e d i n g any power. The o p e r a t i n g system o f t h e C-64 i s s t o r e d 
i n 
a t y p e o f ROM so i t i s i n s t a n t l y a v a i l a b l e when 
t h e 
machine 
i s 
powered up. The t e r m ROM i s sometimes 
used 
l o o s e l y 
t o 
i n c l u d e 


PROMs and EPROMs t o o . 


EPROM HANDBOOK 
INTRO TO EPROMs 
PAGE 2 


Remember, t r u e ROMs have t o have t h e i r i n f o r m a t i o n p u t on a t 
t h e 
f a c t o r y , so t h e y a r e n ' t much use t o us. Much 
more 
u s e f u l 
i s a 
PROM - a Programmable ROM. 
'Programmable' means t h a t we 
c a n 
p u t 
w h a t e v e r 
i n f o r m a t i o n 
we 
d e s i r e 
on 
t h e 
c h i p 
o u r s e l v e s , 
b y 
' p r o g r a m m i n g ' i t w i t h a s p e c i a l 
d e v i c e 
such 
as 
t h e 
PROMENADE 
'programmer'. 
However, we c a n o n l y p r o g r a m a t r u e PROM once s i n c e 
t h e r e i s no way t o e r a s e it. T h i s b r i n g s us t o EPROMs. 
An 
EPROM 
i s an E r a s a b l e PROM. N o t o n l y c a n we p r o g r a m t h e c h i p 
o u r s e l v e s , 
b u t we can a l s o e r a s e and r e p r o g r a m i t many 
t i m e s . 
E r a s i n g 
t h e 
c h i p i s n o t t h e same as w r i t i n g t o it, f o r 
t w o 
r e a s o n s . 
F i r s t , 
t h e e n t i r e c h i p i s e r a s e d a t t h e same t i m e , whereas t h e 
c h i p 
i s 
w r i t t e n t o one b y t e a t a t i m e . Second, when an EPROM 
i s e r a s e d , 
each b i t o f t h e e n t i r e 
c h i p 
i s f i l l e d w i t h 
1 ' s . 
W r i t i n g 
t o 
(programming) an EPROM c a n o n l y change a 1 b i t t o a 0 
b i t . 
When 
an EPROM i s programmed t h e o n l y b i t s t h a t g e t changed 
a r e 
t h o s e 
t h a t c o n t a i n 0 ' s . The 1 b i t s a r e l e f t as i s . 
EPROMs 
a r e 
e r a s e d 
u s i n g s p e c i a l u l t r a v i o l e t (UV) 
l i g h t . 
Complete 
e r a s u r e 
o f 
an 
EPROM g e n e r a l l y t a k e s f r o m 5 t o 15 m i n u t e s . 


The EPROM has a v e r y s p e c i a l 
r e l a t i v e 
c a l l e d 
t h e 
EEPROM. 
The 
EEPROM i s an E l e c t r i c a l l y E r a s e a b l e PROM. 
T h i s means 
t h e 
EEPROM 
may be e r a s e d b y an e l e c t r i c s i g n a l r a t h e r t h a n UV 
l i g h t . 
A l s o , 
s i n g l e b y t e s c a n be e r a s e d w i t h o u t e r a s i n g t h e r e s t o f t h e 
c h i p . 
W h i l e t h e PROMENADE i s c a p a b l e o f programming 
and 
e r a s i n g 
many 


EEPROMs, t h e y a r e r e l a t i v e l y e x p e n s i v e and t h e y 
d o n ' t 
have 
any 
advantages o v e r EPROMs as f a r as t h i s book 
i s concerned. 
W e ' l l 
s t i c k t o EPROM programming i n t h i s book. 


There a r e many t y p e s o f 
EPROMS 
w h i c h 
d i f f e r 
i n memory 
s i z e , 
o r g a n i z a t i o n , speed, number o f p i n s and o t h e r f e a t u r e s . T h i s 
may 
sound l i k e a b e w i l d e r i n g s e t o f f a c t o r s , b u t a l m o s t a l l 
p r o j e c t s 
f o r t h e C-64 c a n be a c c o m p l i s h e d w i t h a 
c o u p l e 
o f 
common 
c h i p 
t y p e s . The memory s i z e ( s t o r a g e c a p a c i t y ) of t h e c h i p i s t h e most 
i m p o r t a n t f a c t o r when y o u ' r e c h o o s i n g an EPROM. 
The 
s i z e 
o f 
a 
c h i p i s i n d i c a t e d b y t h e c h i p 
number. 
F o r 
i n s t a n c e , 
w e ' l l 
be 
u s i n g t h e p o p u l a r 2 7 0 0 - s e r i e s EPROMs, 
w h i c h 
i n c l u d e 
t h e 
2732, 
2764, 27128, 27256 and 27512. The d i g i t s a f t e r t h e 
27 
r e p r e s e n t 
t h e s i z e o f t h e c h i p i n b i t s . A 2732 has 32K b i t s , a 2764 has 64K 
b i t s , e t c . ( l K = 1 0 2 4 ) . S i n c e t h e r e a r e 8 b i t s p e r b y t e , 
y o u 
must 
d i v i d e t h e number o f b i t s b y 8 t o c o n v e r t i t t o b y t e s . T h i s means 
a 2732 has 4K b y t e s , a 2764 has 8K 
b y t e s , 
e t c . 
on 
up 
t o 
t h e 
27512, w h i c h has 64K b y t e s ! The 2764 c h i p ( 8 K ) w i l l be 
t h e 
most 
common EPROM i n t h i s book by f a r . It c a n be used i n an 8K o r 
16K 
c a r t r i d g e o r w i t h a s p e c i a l a d a p t o r t o r e p l a c e t h e KERNAL, BASIC, 
o r 1541 DOS c h i p s . 


The s i z e 
o f 
a 
c h i p 
i n b i t s 
i s 
n o t 
t h e 
w h o l e 
s t o r y . 
The 
o r g a n i z a t i o n o f t h e c h i p i s a l s o i m p o r t a n t , t h a t i s , how t h e b i t s 
a r e grouped. T h i s i s a l s o c a l l e d t h e ' w i d t h ' o r word s i z e o f 
t h e 
c h i p . I n t h e 2700 s e r i e s , 
t h e 
b i t s 
a r e 
o r g a n i z e d 
i n t o 
8 - b i t 
g r o u p s . When y o u r e q u e s t a s i n g l e p i e c e o f d a t a f r o m t h e c h i p , i t 
c o n s i s t s o f 8 b i t s i n one ' c h u n k ' . O t h e r 
t y p e s 
o f 
ROM 
o r 
R A M 
c h i p s may r e t r i e v e t h e i r d a t a i n g r o u p s of 4 b i t s 
( n y b b l e s ) , 
o r 
even as s i n g l e b i t s . As we saw, 
a 2764 has 8K b y t e s w i t h 
8 
b i t s 
each. T h i s i s d e s c r i b e d as 8Kx8 ( n o t i c e how 8Kx8 = 64K b i t s ) . 
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The speed o r access t i m e o f an EPROM r e f e r s t o how f a s t t h e 
c h i p 
can r e s p o n d when d a t a i s r e q u e s t e d f r o m it. The 
access 
t i m e 
i s 
measured i n nanoseconds 
(ns.), 
w h i c h 
means 
b i l l i o n t h s 
o f 
a 
second. T h a t ' s f a s t ! One b i l l i o n (1,000,000,000) 
nanoseconds 
i s 
o n l y one second, w h i l e a b i l l i o n seconds i s a b o u t 32 
y e a r s ! 
The 
C - 6 4 ' s i n t e r n a l c l o c k ' t i c k s ' a mere m i l l i o n t i m e s a 
second, 
o r 
once e v e r y m i c r o s e c o n d . F o r t e c h n i c a l r e a s o n s , EPROMs 
and 
o t h e r 
memory c h i p s f o r t h e C-64 must be more t h a n t w i c e as f a s t as t h i s 
c l o c k . S i n c e 1 m i c r o s e c o n d e q u a l s 1000 ns., 
we need access 
t i m e s 
l e s s t h a n 500 ns. The most common speed t o use i s 450 ns. 
F a s t e r 
c h i p s a r e OK t o use b u t t h e y u s u a l l y 
c o s t 
more 
and 
t h e 
e x t r a 
speed d o e s n ' t make any d i f f e r e n c e . The speed o f a c h i p i s u s u a l l y 
p r i n t e d on i t r i g h t a f t e r t h e c h i p number. 
A 450 ns. 2764 may 
be 
l a b e l l e d "2764-450" o r j u s t "2764-45". 
A 300 ns. c h i p m i g h t 
even 
be 1 a b e l l ed "2764-3'. 


EPROMs a r e s u p p l i e d i n c e r a m i c D I P S ( d u a l i n l i n e 
packages) 
w i t h 
many m e t a l ' l e g s 1 o r p i n s f o r c o n n e c t i n g t h e EPROM t o t h e o u t s i d e 
w o r l d . The a c t u a l s i l i c o n c h i p a t t h e h e a r t o f an EPROM 
i s much 
s m a l l e r t h a n t h e case, t y p i c a l l y 1 / 4 i n c h s q u a r e o r 
s m a l l e r . 
It 
i s v i s i b l e t h r o u g h t h e window on t o p o f 
t h e 
EPROM. 
The 
EPROMs 
w e ' l l be c o n c e r n e d w i t h have e i t h e r 24 o r 28 p i n s . The 
2732 
has 
24 p i n s and t h e 2764, 27128 and 27256 have 28 p i n s . As w i t h o t h e r 
i n t e g r a t e d c i r c u i t s ( I C s ) , t h e p i n s a r e numbered 
i n a 
s t a n d a r d 
way. One end o f t h e EPROM has a n o t c h o r d o t on it. L o o k i n g 
a t 
t h e EPROM f r o m t h e t o p , t h e p i n s 
a r e 
numbered 
c o u n t e r c l o c k w i s e 
from t h e n o t c h , s t a r t i n g w i t h p i n #1 ( s e e f i g u r e 1-11. It i s v e r y 
i m p o r t a n t t o remember w h i c h end 
o f 
an 
EPROM 
i s w h i c h , 
s i n c e 
i n s e r t i n g i t i n a c i r c u i t t h e wrong way 
can 
damage 
t h e 
EPROM. 
U s u a l l y t h e c i r c u i t b o a r d a n d / o r t h e s o c k e t w i l l a l s o have a mark 
t o a i d i n i n s e r t i n g t h e EPROM p r o p e r l y . 


O t h e r 
d i f f e r e n c e s 
among 
EPROMs 
i n c l u d e 
power 
consumption, 
programming 
and 
e r a s u r e 
t i m e . 
Power 
c o n s u m p t i o n 
i s n o t 
an 
i m p o r t a n t f a c t o r when c h o o s i n g 
EPROMs 
f o r 
t h e 
C-64. 
However, 
s i n c e t h e C - 6 4 ' s power s u p p l y i s b a r e l y 
s u f f i c i e n t 
f o r 
normal 
use, we recommend t h a t y o u d o n ' t have 
more 
t h a n 
10 
a d d i t i o n a l 
EPROMs p l u g g e d i n t o t h e computer a t any one t i m e . Programming and 
e r a s u r e t i m e w i l l v a r y 
c o n s i d e r a b l y 
f r o m 
one 
m a n u f a c t u r e r 
t o 
a n o t h e r ( e v e n f r o m c h i p t o c h i p ) , s o t h e b e s t 
g u i d e 
t o 
e r a s i n g 
EPROM i s y o u r own e x p e r i e n c e . I f y o u f i n d a b r a n d y o u 
l i k e , 
t r y 
t o s t a y w i t h i t . T h i s s h o u l d n ' t be a m a j o r 
concern, 
though, 
so 
d o n ' t f i g h t r a t h e r t h a n 
s w i t c h ! 
( e s p e c i a l l y 
i f t h e 
p r i c e 
i s 
r i g h t ) . 


B e f o r e we move on t o t h e n e x t c h a p t e r t h e r e i s one more p o i n t 
t o 
c o n s i d e r when l o o k i n g a t EPROMs; t h e 
s i z e 
o f 
t h e 
MATRIX. 
The 
MATRIX i s what y o u see when y o u l o o k t h r o u g h 
t h e 
window 
o f 
an 
EPROM. F o r t h e b e g i n n i n g EPROM 
u s e r , 
t h e 
b i g g e r , 
t h e 
b e t t e r . 
L a r g e MATRIX EPROMs w i l l be more f o r g i v i n g t o programming e r r o r s . 
T h i s i s due t o t h e p h y s i c a l s i z e o f t h e i n t e r n a l components. 
The 
l a r g e r t h e i n t e r n a l s t r u c t u r e , t h e g r e a t e r 
t h e 
abuse 
t h a t 
t h e 
c h i p can w i t h s t a n d b e f o r e f a i l i n g . There 
i s a b s o l u t e l y 
n o t h i n g 
wrong w i t h s m a l l MATRIX c h i p s , we j u s t d o n ' t recommend 
them 
f o r 
b e g i n n e r s . D u r i n g t h e f i r s t f e w t i m e s 
t h a t 
y o u 
program 
EPROMs 
y o u ' r e 
l i k e l y 
t o make 
a 
f e w 
m i s t a k e s . 
G i v e 
y o u r s e l f 
some 
l a t i t i u d e and g e t t h e b i g MATRIX c h i p s i f y o u have a c h o i c e . 


EPROM HANDBOOK 
INTRO TO EPROMs 
PAGE 4 


HOW EPROMS WORK 


I n t h i s c h a p t e r we w i l l t r y p r e s e n t a l a y m a n ' s v i e w o f how EPROMs 
work, why i t p o s s i b l e t o p r o g r a m them, how t o e r a s e them and 
how 
t o a v o i d some o f t h e more common p r o b l e m s a s s o c i a t e d 
w i t h 
EPROM 
programming. 


When t h e u s e r f i r s t t r i e s t o program an EPROM, t h e r e i s a 
l a r g e 
number o f unanswered q u e s t i o n s . What happens 
when 
a 
c h i p 
g e t s 
programmed? What a c t u a l l y i s g o i n g 
on 
i n s i d e 
t h e 
c h i p ? If I 
e x p e r i e n c e a problem, how do I e r a s e t h e c h i p ? What happens 
when 
t h e c h i p i s e r a s e d ? How do I know i f a c h i p i s f u l l y e r s a s e d ? 


An a w f u l l o t o f q u e s t i o n s , r i g h t ? 
You can r e s t a s s u r e d 
t h a t 
we 
w i l l c l a r i f y t h e common c o n c e r n s o f a l l t h o s e who program EPROMs. 
Any t i m e y o u l e a r n a new 
c o n c e p t 
t h e r e 
a r e 
s u r e 
t o 
be 
some 
unanswered q u e s t i o n s and u n e x p e c t e d problems. We f e e l t h a t i f y o u 
have a b e t t e r u n d e r s t a n d i n g of how an EPROM works and 
what 
goes 
on i n s i d e , y o u ' l l be more c o m f o r t a b l e w i t h them. 


One p r o b l e m t h a t many p e o p l e have e x p e r i e n c e d i s t h a t 
o f 
b u y i n g 
used o r s u r p l u s EPROMs ( y o u w o u l d n ' t buy used d i s k s 
w o u l d 
y o u ? ) 
D o n ' t buy used EPROMS, f a c t o r y seconds o r s u r p l u s goods. You j u s t 
c a n ' t be s u r e o f t h e q u a l i t y t h a t y o u a r e g e t t i n g . 
Some 
o f 
t h e 
s u r p l u s EPROMs a r e q u i t e r e l i a b l e , some a r e n o t , so 
why 
t a k e 
a 
chance? U n t i l y o u g a i n t h e 
e x p e r i e n c e 
n e c e s s a r y 
t o 
j u d g e 
f o r 
y o u r s e l f w h e t h e r a s u r p l u s EPROM i s good o r n o t , s t a y 
away 
f r o m 
them. 


EPROMs have e v o l v e d d u r i n g t h e p a s t f e w y e a r s . 
When 
t h e y 
f i r s t 
came o u t t h e y were 
f a i l u r e - p r o n e , 
s u b j e c t 
t o 
q u a l i t y 
c o n t r o l 
problems and v e r y e x p e n s i v e . W i t h t h e g r e a t l e a p s 
i n t e c h n o l o g y 
t h a t 
have 
o c c u r r e d 
d u r i n g 
t h e 
p a s t 
f e w 
y e a r s , 
t h e 
EPROM 
m a n u f a c t u r e r s have l e a r n e d t o overcome many, i f n o t a l l , 
of 
t h e 
weaknesses o f t h e e a r l y EPROMs. Today, EPROMs 
a r e 
t o p 
q u a l i t y , 
l o n g - l a s t i n g and v e r y c o s t - e f f e c t i v e . 
The 
p r i c e 
o f 
EPROMs 
has 
come way down and a t t h e same t i m e t h e q u a l i t y has gone 
way 
up. 
What a l l t h i s means t o you, t h e end u s e r , i s more r e l i a b l e memory 
f o r l e s s money. 


The r e a s o n t h a t we r e f l e c t back on t h e e a r l y days 
o f 
EPROMs 
i s 
because many p e o p l e a r e s i m p l y n o t aware o f 
t h e 
g r e a t 
advances 
t h a t have been made. T h i s a l s o a l l o w s us c o n c e n t r a t e o u r 
e f f o r t s 
i n t h i s book t o w r i t i n g a b o u t t h e newer and more r e l i a b l e 
memory 
c h i p s a v a i l a b l e t o d a y . Much o f t h e i n f o r m a t i o n 
w r i t t e n 
i n t h i s 
c h a p t e r j u s t was n o t t r u e w i t h t h e o l d e r 
EPROMs. 
When 
y o u 
a r e 
l o o k i n g f o r EPROMs t o buy, i n s i s t 
upon 
f i r s t 
q u a l i t y , 
f a c t o r y 
f r e s h EPROMs, n o t s u r p l u s 
o r 
seconds. 
F i f t e e n y e a r s 
ago 
t h e 
f l o p p y d i s k was c o n s i d e r e d u n r e l i a b l e and 
f a i l u r e - p r o n e . 
D u r i n g 
t h e p a s t f e w y e a r s we have seen advances come a b o u t where 
f l o p p y 
d i s k s have become v e r y r e l i a b l e , so i t i s w i t h t h e 
EPROM. 
D o n ' t 
l e t anyone t e l l y o u t h a t EPROMs a r e u n r e l i a b l e o r e x p e n s i v e - i t 
j u s t a i n ' t so any more... 
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L e t ' s g e t down t o j u s t what goes on i n s i d e an EPROM. 
We 
a r e 
n o t 
g o i n g t o c o n c e r n y o u h e r e w i t h a bunch o f m e a n i n g l e s s 
f a c t s 
and 
f i g u r e s . R a t h e r t h a n c o n f u s e and 
b o r e 
you, 
we 
w o u l d 
l i k e t o 
p r e s e n t an o v e r v i e w o f j u s t what i s g o i n g on i n s i d e t h e c h i p . The 
i n f o r m a t i o n t h a t we a r e p r e s e n t i n g h e r e i s n o t g o i n g t o make 
y o u 
program EPROMs b e t t e r , b u t i t may 
j u s t 
c l e a r 
up 
some 
o f 
t h e 
m y s t e r y s u r r o u n d i n g an EPROM's o p e r a t i o n . 


When we r e c e i v e an EPROM f r o m t h e f a c t o r y i t i s f u l l y 
e r a s e d . 
T h i s means t h a t a l l t h e b i t s have been 
s e t 
t o 
a 
v a l u e 
o f 
1. 
EPROMs a r e e r a s e d b y e x p o s i n g t h e MATRIX 
t o 
U l t r a 
V i o l e t 
(UV) 


l i g h t . T h i s causes a l l t h e b i t s t o r e t u r n t o t h e v a l u e o f 1. 
The 
MATRIX i s t h e p a r t t h a t i s v i s i b l e 
when 
y o u 
l o o k 
t h r o u g h 
t h e 
window o f an EPROM. When an EPROM i s programmed, 
t h e 
MATRIX 
i s 
t h e p a r t t h a t a c t u a l l y s t o r e s t h e d a t a . The d a t a i s s t o r e d 
as 
a 
s e r i e s o f 1 ' s and 0 ' s i n t h e MATRIX. 
S i n c e 
t h e 
c h i p 
i s f u l l y 
e r a s e d b e f o r e we p r o g r a m i t ( a l l b i t s I ) , a l l t h a t 
i s n e c e s s a r y 
t o do i s c r e a t e t h e 0 b i t s b y programming. The 1 b i t s a r e l e f t as 
i s . When an EPROM i s erased, i t i s t h e MATRIX 
t h a t 
i s a f f e c t e d 
and a l l t h e b i t s a r e r e t u r n e d t o t h e v a l u e o f 1. 


I n t h e f o l l o w i n g i l l u s t r a t i o n we w i l l be e x a m i n i n g t h e 2764 EPROM 
(8K x 8 ) . T h i s i s t h e most common t y p e o f 
EPROM 
t h a t 
y o u 
w i l l 
e n c o u n t e r . The 2764 c o n t a i n s 8K ( 8 1 9 2 ) b y t e s 
of 
d a t a 
and 
each 
b y t e i s composed o f 8 b i t s each (hence, 8K 
x 
8 ) . 
Each 
o f 
t h e 
b y t e s c o n t a i n s 8 b i t s and 8 b i t s o n l y . Each b i t may o n l y be 
a 
1 
o r a 0. T h e r e i s no o t h e r p o s s i b l e s t a t e f o r a b i t . I n an 
EPROM, 
any t i m e a b i t i s r e f e r e d t o as b e i n g a ' 1 ' i t a l s o 
means 
t h a t 
t h e b i t i s ' O N ' o r t h a t an i n t e r n a l c o n n e c t i o n i s made. 
When 
a 
b i t i s r e f e r r e d t o as a ' O ' , i t means t h a t t h e b i t 
i s 
'OFF' 
o r 
t h a t an i n t e r n a l c o n n e c t i o n i s b r o k e n ( n o t c o n n e c t e d ) . Now 
w e ' r e 
r e a d y t o see what goes on i n s i d e an EPROM. 


L e t ' s t a k e a s i m p l i f i e d l o o k a t how an EPROM works. T h i s w i l l 
be 
a c o n c e p t u a l view, 
w i t h o u t 
g e t t i n g 
i n t o 
t h e 
a c t u a l 
p h y s i c a l 
c o n s t r u c t i o n o f t h e MATRIX ( a l t h o u g h i t i s s i m i l a r t o 
t h e 
model 
d e s c r i b e d h e r e ) . C o n s u l t f i g u r e 2-1. 
Each b y t e i n t h e 
EPROM 
i s 
r e p r e s e n t e d b y one row ( h o r i z o n t a l l i n e ) i n t h e diagram. One b y t e 
i s e i g h t b i t s . The 8 columns ( v e r t i c a l 
l i n e s ) 
r e p r e s e n t 
t h e 
8 
b i t s o f each b y t e . A t each i n t e r s e c t i o n o f a r o w and column i s a 
t i n y ' f u s e ' r e p r e s e n t i n g a s i n g l e b i t . When t h e f u s e 
i s i n t a c t , 
e l e c t r i c i t y can f l o w f r o m t h e row l i n e t o t h e column 
l i n e . 
T h i s 
r e s u l t s i n a ' 1 ' b i t . When t h e f u s e i s ' b l o w n ' no c u r r e n t 
f l o w s , 
w h i c h g i v e s us a ' 0 ' b i t . I n a PROM, 
t h e s e f u s e s 
a r e 
j u s t 
l i k e 
h o u s e h o l d f u s e s s i n c e once t h e y ' r e blown, t h e y ' r e b l o w n f o r good. 
I n an EPROM, t h e f u s e s a r e more 
l i k e 
' c i r c u i t 
b r e a k e r s ' 
s i n c e 
t h e y can be r e s e t a f t e r b e i n g blown, i f d e s i r e d . When y o u e r a s e a 
c h i p w i t h UV l i g h t , i t r e s e t s 
a l l 
o f 
t h e 
f u s e s 
back 
t o 
t h e 
c o n n e c t e d s t a t e ( 1 ' s ) . L e t t h e e n g i n e e r s w o r r y a b o u t why UV l i g h t 
e r a s e s EPROMs - j u s t be g l a d t h a t i t works. 
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B y t e s a r e numbered ( a d d r e s s e d ) i n t e r n a l l y i n t h e 
EPROM 
s t a r t i n g 
a t 0, r e g a r d l e s s o f where i n t h e c o m p u t e r ' s memory t h e 
EPROM 
i s 
l o c a t e d . Remember, t h e i n t e r n a l memory o f t h e EPROM ALWAYS b e g i n s 
a t b y t e 0. It i s t h e computer 
t h a t 
d e t e r m i n e s 
where 
an 
EPROM 
r e s i d e s ( i . e . 
$2000 o r $8000 o r 
$E000). 
T h i s 
i s i m p o r t a n t 
t o 
remember, s i n c e many p e o p l e a r e confused 
a b o u t 
t h i s 
p o i n t . 
I n 
l a t e r c h a p t e r s we w i l l see 
how 
t h e 
a d d r e s s 
o f 
t h e 
EPROM 
i n 
c o m p u t e r ' s memory i s d e t e r m i n e d . To r e a d a b y t e o f d a t a 
f r o m 
an 
EPROM, t h e m i c r o p r o c e s s o r sends t h e b y t e ' s a d d r e s s t o t h e EPROM's 
a d d r e s s i n p u t l i n e s . S p e c i a l ' r o w d e c o d i n g ' c i r c u i t r y ( n o t shown) 
s e l e c t s t h e row c o r r e s p o n d i n g t o t h e r e q u e s t e d b y t e . 
E l e c t r i c i t y 
i s t h e n a p p l i e d t o t h a t r o w l i n e . Any i n t e r s e c t i o n w h i c h 
has 
an 
i n t a c t f u s e w i l l a l l o w c u r r e n t t o c r o s s o v e r t o t h e c o r r e s p o n d i n g 
column l i n e . S p e c i a l d e t e c t o r s on each column l i n e r e g i s t e r a ' 1 ' 
b i t whenever t h e y d e t e c t t h i s c u r r e n t 
on 
t h e i r 
own 
l i n e . 
The 
o u t p u t f r o m t h e s e b i t d e t e c t o r s i s s e n t t o t h e d a t a l i n e s o f 
t h e 
EPROM, where t h e m i c r o p r o c e s s o r can r e a d i t . I n t h e 
t o p 
row 
o f 
f i g u r e 2-1 ( b y t e O), t h e f i r s t f u s e i s i n t a c t , as 
shown 
b y 
t h e 
s o l i d c i r c l e , so we 
have 
a 
1 
The 
second 
f u s e 
i s blown, 
i n d i c a t e d b y t h e open c i r c l e , so we have a ' 0 ' . The c o m p l e t e b y t e 
i s 10001101. T h a t ' s a l l t h e r e i s t o i t . P r e t t y s i m p l e , i s n ' t i t ? 


To ' b u r n ' ( p r o g r a m ) a c h i p , a s i m i l a r p r o c e s s i s used. F i r s t 
t h e 
c h i p must be e r a s e d , b y U V l i g h t , so t h a t a l l f u s e s 
a r e 
i n t a c t . 
T h i s means a1 1 b i t s a r e i n i t i a l l y s e t t o t h e v a l u e of 1 and 
t h a t 
each b y t e i s 11111111 ($FF i n h e x ) . The e n t i r e c h i p i s programmed 
one b y t e a t a t i m e . F i r s t b y t e 0 i s programmed, t h e n b y t e 1, b y t e 
2, e t c . The a d d r e s s o f t h e b y t e t o be programmed 
i s decoded 
by 
t h e c h i p and t h e p r o p e r 
r o w 
i s s e l e c t e d . 
A 
r e l a t i v e l y 
l a r g e 
v o l t a g e (appx. 25 v o l t s ) i s a p p l i e d t o t h i s row l i n e . To 
program 
a " 0 " b i t , t h e 
p r o p e r 
column 
l i n e 
i s grounded. 
T h i s 
a l l o w s 
c u r r e n t t o pass t h r o u g h t h e c o r r e s p o n d i n g f u s e , w h i c h ' b l o w s ' it. 
From t h e n on, no c u r r e n t c a n pass t h r o u g h t h e f u s e 
u n t i l i t i s 
r e s e t b y e r a s i n g t h e EPROM. 
No 
s p e c i a l 
p r o c e s s 
i s needed 
t o 
program a ' 1 ' b i t . S i n c e e r a s e d c h i p s a r e a l r e a d y f i l l e d w i t h 1 ' s 
( i n t a c t f u s e s ) 
t h e 
1 
b i t s 
w i l l 
be 
l e f t 
as 
i s . 
N o t e 
t h a t 
i n d i v i d u a l b y t e s a r e programmed one b y t e a t a t i m e , b u t t h e 
c h i p 
must be e r a s e d as a whole. 


T h i s simp1 i f i e d d e s c r i p t i o n i g n o r e s t h e c o n t r o l 1 i n e s 
t h a t 
must 
be m a n i p u l a t e d i n o r d e r t o r e a d and w r i t e t h e EPROM, 
as 
w e l l 
as 
t h e u n d e r l y i n g p h y s i c a l p r o c e s s e s . F o r t h e p e r s o n who 
w i s h e s 
t o 
u s e an EPROM programmer, no f u r t h e r e x p l a n a t i o n i s n e c e s s a r y 
o r 
w a r r a n t e d . 
I f y o u 
f i n d y o u r s e l f 
d e s i r i n g 
a 
more 
c o m p l e t e 
d e s c r i p t i o n o f t h e p h y s i c a l and e l e c t r i c a l s u b j e c t s , see chap. 26 
of t h e PROGRAM PROTECTION MANUAL, V o l . 11. 
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Figure 2-1: 
EPROM Model 


B y t e 0 


B y t e 1 


B y t e 2 


and so ,.. 


We 
now need t o examine t h e p r o c e s s o f e r a s i n g EPROMs. E r a s i n g 
an 
EPROM r e s t o r e s a l l o f t h e b i t s t o a v a l u e o f ' 1 ' ( y o u 
may 
t h i n k 
o f i t as r e s e t t i n g t h e c i r c u i t b r e a k e r s ) . I n o r d e r 
t o 
e r a s e 
an 
EPROM, 
t h e MATRIX must be d i r e c t l y exposed t o UV 
l i g h t . 
The 
UV 
l i g h t causes a r e a c t i o n t o o c c u r w i t h i n t h e MATRIX t h a t 
r e s t o r e s 
a l l t h e b i t s t o a v a l u e o f 1. The a c t u a l p r o c e s s t h a t o c c u r s when 
an EPROM i s e r a s e d i s beyond t h e scope o f t h i s book. I f e e l i t i s 
n o t as i m p o r t a n t t o know WHY an EPROM may be e r a s e d , as i t i s t o 
know HOW t o e r a s e an EPROM p r o p e r l y . 


P r o p e r l y 
e r a s i n g 
EPROMs 
depends 
upon 
a 
number 
o f 
f a c t o r s 
i n c l u d i n g : 
. The t y p e o f UV l i g h t s o u r c e ( s u n , f l u o r e s c e n t l i g h t , f l a m e 
o r 
commerci a1 U V 1 i 
g h t s ) . 
. D i s t a n c e o f t h e EPROM f r o m t h e s o u r c e o f l i g h t . 
. M a n u f a c t u r e r 
of 
c h i p 
( d i f f e r e n t 
m a n u f a c t u r e r s 
v a r y 
t h e 
i n t e r n a l s t r u c t u r e ) . 
4. MATRIX s i z e (many m a n u f a c t u r e r s u s e d i f f e r e n t s i z e MATRIXs f o r 
s i m i l i a r c h i p s ) . 
5 . C l e a n l i n e s s o f t h e window. 
6. L e n g t h o f e x p o s u r e t i m e t o U V l i g h t s o u r c e . 


O f a l l f a c t o r s a f f e c t i n g EPROM e r a s i n g , t h e 
t w o 
most 
i m p o r t a n t 
a r e t h e amount UV l i g h t r e a c h i n g t h e c h i p and e x p o s u r e t i m e . 
The 
amount o f U V l i g h t a c t u a l l y r e a c h i n g t h e c h i p 
i s i n f l u e n c e d 
b y 
t h e s o u r c e o f l i g h t , d i s t a n c e f r o m t h e s o u r c e and c l e a n l i n e s s 
o f 
t h e window. 
A l l t h r e e o f t h e s e f a c t o r may e a s i l y be c o n t r o l l e d b y 
c l e a n i n g t h e window b e f o r e e r a s i n g and u s i n g a 
commercial 
EPROM 
e r a s e r o f known q u a l i t y . The o n l y r e a l v a r i a b l e t h e n becomes 
t h e 
t i m e t h a t t h e c h i p i s exposed t o t h e U V l i g h t o f 
t h e 
commercial 
programmer. 


* 
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An EPROM exposed t o f l u o r e s c e n t l i g h t o r t o l i g h t 
f r o m 
a 
f l a m e 
( c a n d l e , match, e t c . ) may r e q u i r e many y e a r s t o f u l l y 
e r a s e . 
An 
EPROM exposed t o d i r e c t s u n l i g h t s h o u l d be 
f u l l y 
e r a s e d 
i n 14 
days o r l e s s . The same EPROM c a n be e r a s e d 
i n as 
l i t t l e as 
2 
m i n u t e s when exposed t o t h e UV 
l i g h t 
f r o m 
a 
commercial 
EPROM 
e r a s e r . T y p i c a l e r a s e t i m e s v a r y f r o m 
2 
m i n u t e s 
( m i n . ) 
t o 
20 
m i n u t e s (max.) 
f o r c o m m e r c i a l e r a s e r s . The 
EPROMs 
t h a t 
we 
a r e 
c u r r e n t l y s e e i n g on t h e m a r k e t n o r m a l l y may be 
f u l l y 
e r a s e d 
i n 
l e s s t h a t 10 m i n u t e s . F o r a l l o u r d i s c u s s i o n s 
i n t h i s 
book 
we 
w i l l assume t h a t y o u a r e u s i n g a 
commercial 
EPROM 
e r a s e r . 
The 
o n l y r e a s o n t h a t we m e n t i o n f l u o r e s c e n t l i g h t and s u n l i g h t i s t o 
make y o u aware o f t h e p o t e n t i a l f o r a c c i d e n t a l e r a s u r e f r o m t h e s e 
s o u r c e s . We recommend t h a t t h e window be c o v e r e d w i t h 
an 
opaque 
m a t e r i a l o r w r i t e p r o t e c t t a b t o p r e v e n t a c c i d e n t a l e r a s u r e . 


O r d i n a r i l y , o v e r e x p o s u r e t o UV l i g h t i s n o t a problem, u n l e s s t h e 
EPROM i s l e f t i n a commercial e r a s e r f o r more t h a n 
2 
days. 
The 
l i f e o f an EPROM i s d e t e r m i n e d , t o an e x t e n t , b y 
t h e 
amount 
of 
t i m e t h a t i t spends b e i n g e r a s e d . G e n e r a l l y 
s p e a k i n g , 
t h e 
l e s s 
t i m e s p e n t i n e r a s i n g an EPROM t h e l o n g e r i t s l i f e . 
I f y o u 
can 
f u l l y e r a s e an EPROM i n 2 m i n u t e s , d o n ' t expose i t t o 15 
m i n u t e s 
o f l i g h t . F o r example, l e t ' s 
assume 
b r a n d 
' X ' 
EPROMs 
may 
be 
exposed t o a t o t a l o f 8 0 h o u r s o f UV l i g h t b e f o r e damage 
t o 
t h e 
c h i p o c c u r s . I f t h e t i m e f o r f u l l e r a s u r e i s 2 m i n u t e s , 
we 
w i l l 
be a b l e t o e r a s e t h e 
c h i p 
2,400 
t i m e s 
b e f o r e 
damage 
o c c u r s . 
Whereas, i f we r o u t i n e l y l e a v e t h e same c h i p i n t h e e r a s e r f o r 15 
m i n u t e s we w i l l o n l y e x p e r i e n c e 320 e r a s u r e s b e f o r e damage o c c u r s 
t o t h e same c h i p . W h i l e we a r e o n t h e s u b j e c t o f 
EPROM 
e r a s i n g , 
we w o u l d 
l i k e 
t o 
recommend 
a 
l o w 
c o s t 
( c u r r e n t l y 
$34.95), 


w e l l - b u i l t EPROM e r a s e r : 
t h e DATARASE. The DATARASE 
w i l l 
e r a s e 
t w o EPROMs a t t h e same t i m e and r e q u i r e s o n l y 2 t o 
f i v e 
m i n u t e s 
on t h e average. The 
DATARASE 
i s a v a i l a b l e 
d i r e c t l y 
f r o m 
CSM 
SOFTWARE; c a l l o r w r i t e f o r c u r r e n t p r i c e and d e l i v e r y . 


F o r t h o s e of y o u who w i s h t o b u i l d y o u own EPROM e r a s e r h e r e 
a r e 
some g u i d e l i n e s t o use: 


1. Be s u r e t o make t h e e r a s e r l i g h t p r o o f , t h e r e b y p r e v e n t i n g 
ANY 
r e l e a s e o f UV l i g h t f r o m t h e u n i t . UV l i g h t can 
be 
hazardous 
t o y o u r h e a l t h ( e y e s and s k i n i n p a r t i c u l a r ) . 
2. Recommended 
e x o p s u r e 
i s : 
' 1 5 
WATT 
SECONDS 
PER 
SQUARE 
CENTIMETER OF 254 NANOMETER WAVELENGTH RADIATION'. 
3. P r a c t i c a l e x p o s u r e i s a c h i e v e d i n most c a s e s 
b y 
p l a c i n g 
t h e 
EPROM 1 i n c h f r o m t h e UV lamp. 


A g a i n t h e s e a r e o n l y g u i d e l i n e s b y w h i c h t o make y o u r 
own 
EPROM 
e r a s e r . We do n o t recommend t h a t y o u a t t e m p t t o b u i l d 
o r 
m o d i f y 
an EPROM e r a s e r . 


F i n a l l y letl's 
c o v e r some o f t h e more common i t e m s a n d / o r m i s t a k e s 
t h a t t h e b e g i n n e r s s h o u l d b e aware o f : 


1. U s i n g s u r p l u s o r used EPROMs - D o n ' t do it, t h e y 
j u s t 
l e a v e 
t o o much t o chance. 
2. Jumping 
i n b e f o r e 
t h e y 
u n d e r s t a n d 
t h e 
b a s i c s 
o f 
EPROM 
programming - Take a l i t t l e t i m e t o l e a r n e v e r y t h i n g 
y o u 
can 
b e f o r e you b u r n y o u r f i r s t EPROM. 
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3. Be s u r e t o u s e t h e p r o p e r commands f o r y o u r 
p a r t i c u l a r 
EPROM 
programmer - Each EPROM 
programmer 
uses 
new 
and 
d i f f e r e n t 
commands. 
4. Watch o u t f o r s t a t i c 
e l e c t r i c i t y - 
S t a t i c 
e l e c t r i c i t y 
can 
p e r m a n e n t l y damage EPROMs. Use c a r e when h a n d l i n g EPROMs. 
5 . D o n ' t bend t h e p i n s o f t h e EPROM - y o u m i g h t 
j u s t 
b r e a k 
one 
o f f . 
6. Keep t h e p i n s o f t h e EPROM c l e a n and s t r a i g h t . 
7. Keep t h e window c o v e r e d when n o t 
e r a s i n g 
t h e 
EPROM - 
When 
e r a s i n g t h e EPROM b e s u r e i t i s c l e a n and f r e e o f a l l d e b r i s 
8. An EPROM i s f u l l y e r a s e d when a l l t h e b i t s 
have 
r e t u r n e d 
t o 
t h e v a l u e o f ' 1 ' . T h i s may be t e s t e d b y r e a d i n g an EPROM a f t e r 
e r a s i n g ; a l l t h e b y t e s s h o u l d be $FF ( a l l b i t s w i l l be 1 ) . 


I ' m s u r e t h a t y o u a r e a l l r e a d y t o move on now and a c t u a l l y 
b u r n 
an EPROM. So l e t ' s g e t t o i t . 
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BURNING EPROMS 


B u r n i n g EPROMs, w e l l , t h a t ' s t h e w h o l e p u r p o s e o f t h i s 
book. 
I n 
t h i s c h a p t e r we a r e g o i n g t o t r y t o communicate t o y o u 
j u s t 
how 
y o u a c t u a l l y p r o g r a m 
an 
EPROM. 
T h i s 
w i l l 
be 
a 
g r a s s 
r o o t s 
approach - making 
a 
copy 
o f 
an 
EPROM, 
i n s t a l l i n g i t i n a 
c a r t r i d g e and v e r i f y i n g t h a t i t a c t u a l l y works. 


I n t h i s c h a p t e r and t h r o u g h o u t t h e r e s t o f t h i s manual we w i l l be 
w o r k i n g w i t h t h e PROMENADE EPROM programmer. 
We 
f e e l 
t h a t 
t h e 
PROMENADE i s s i m p l y t h e b e s t , e a s i e s t t o use, most r e l i a b l e , most 
v e r s a t i l e and 
c o s t - e f f e c t i v e 
EPROM 
programmer 
on 
t h e 
m a r k e t 
t o d a y . The PROMENADE w i l l p r o g r a m many d i f f e r e n t k i n d s o f 
PROMS, 


EPROMs and EEPROMs ( E l e c t r i c a l l y E r a s a b l e Programmable Read 
O n l y 
Memory). We have seen a l a r g e number o f v e r y " s o p h i s t i c a t e d " 
and 
e x p e n s i v e EPROM programmers t h a t c o u l d n o t even come c l o s e t o t h e 
P R O M E N A D E ' S c a p a b i l i t i e s . I f y o u a r e u s i n g a n o t h e r b r a n d o f EPROM 
programmer i t w i l l be n e c e s s a r y f o r y o u t o u s e a d i f f e r e n t s e t o f 
commands t h a t a p p l y t o y o u r programmer. We w i l l t r y t e l l y o u what 
each command does on t h e PROMENADE, 
so t h a t y o u w i l l be 
a b l e 
t o 
f i g u r e 
o u t 
t h e 
c o r r e c t 
commands 
t o 
s u b s t i t u t e 
f o r 
y o u r 
programmer. 


THE PROMENADE 


I f y o u have j u s t p u r c h a s e d a 
PROMENADE 
EPROM 
programmer, 
t h i s 
c h a p t e r 
w i l l 
h e l p 
f a m i l i a r i z e 
y o u 
w i t h 
i t s most 
i m p o r t a n t 
f e a t u r e s . I f y o u ' r e a l r e a d y f a m i l i a r 
w i t h 
y o u r 
PROMENADE, 
y o u 
s h o u l d s t i l l r e a d t h i s c h a p t e r i n o r d e r t o 
r e f r e s h 
and 
c l a r i f y 
y o u r 
u n d e r s t a n d i n g . 
I f y o u 
own 
some 
o t h e r 
t y p e 
o f 
EPROM 
programmer, y o u ' l l need 
t o 
r e f e r 
t o y o u r 
owners 
manual 
f o r 
s p e c i f i c commands, b u t y o u can s t i l l 
b e n e f i t 
f r o m 
t h e 
g e n e r a l 
i n f o r m a t i o n i n t h i s c h a p t e r . 


The 
PROMENADE 
EPROM 
programmer 
i s 
m a n u f a c t u r e d 
b y 
t h e 
JASON-RANHEIM COMPANY ( J - R ) , 
and i s a v a i l a b l e d i r e c t l y 
f r o m 
CSM 
S o f t w a r e I n c . I t i s c o m p a t i b l e w i t h t h e Commodore VIC-20, 
C64 and 


C128. I n t h i s book w e ' l l assume t h a t y o u have a C64 ( o r 
C128 
i n 
C64 mode) s i n c e t h e V I C ' s l i m i t e d memory i s a r e a l h a n d i c a p . 
The 
PROMENADE 
i s a 
v e r y 
v e r s a t i l e 
and 
r e l i a b l e 
i n s t r u m e n t . 
I n 
a d d i t i o n t o a l l i t s c a p a b i l i t i e s , t h e PROMENADE i s a l s o v e r y easy 
t o 
u s e 
because 
o f 
t h e 
PROMOS 
s o f t w a r e 
( i n c l u d e d 
w i t h 
t h e 
PROMENADE). 
PROMOS g i v e s 
y o u 
easy 
access 
t o 
t h e 
P R O M E N A D E ' S 


f e a t u r e s b y a d d i n g s e v e r a l commands t o BASIC. These commands 
can 
a l s o be used d i r e c t l y from a c o m p a t i b l e machine l a n g u a g e 
m o n i t o r 
(MICROMON, s u p p l i e d on t h e d i s k w i t h 
t h i s 
book, 
i s c o m p a t i b l e 
w i t h PROMOS). The r e t a i l p r i c e o f t h e PROMENADE i s $99.50 
( a s 
o f 
1 1 / 8 5 ) , w h i c h i n c l u d e s an i n s t r u c t i o n manual and PROMOS 
d i s k e t t e 
o r t a p e . I t i s a v a i l a b l e d i r e c t l y from C S M S o f t w a r e I n c . CSM a l s o 
o f f e r s c a r t r i d g e b o a r d s i n c l u d i n g s e v e r a l 
b a n k - s w i t c h e d 
models, 
one o f w h i c h i s c a p a b l e o f h o l d i n g up t o 256K on a s i n g l e 
b o a r d ! 


ThePROMENADE 
and 
o t h e r 
s u p p l i e s 
such 
as 
EPROMs 
and 
EPROM 
e r a s e r s , c a r t r i d g e b o a r d s and cases a r e a l l 
a v a i l a b l e 
f r o m 
CSM 


S o f t w a r e I n c . 
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The PROMENADE i t s e l f c o n s i s t s o f a c i r c u i t b o a r d 
e n c l o s e d 
i n a 
brushed aluminum c a s e w h i c h d o u b l e s as a s t a t i c - f r e e 
s u r f a c e 
t o 
r e s t EPROMs on. The d e v i c e p l u g s i n t o t h e u s e r 
(modem) 
p o r t 
a t 
t h e l e f t r e a r o f t h e Commodore 64, 
128 o r 
VIC-20. 
A 
Z I F 
( z e r o 
i n s e r t i o n f o r c e ) s o c k e t i s mounted 
on 
t h e 
PROMENADE'S 
c i r c u i t 
board. T h i s makes i n s e r t i n g and r e m o v i n g EPROMs 
v e r y 
easy. 
The 
Z I F has a s m a l l h a n d l e w h i c h l o c k s t h e c h i p i n t o t h e s o c k e t . F l i p 
t h e h a n d l e down t o l o c k t h e c h i p i n p l a c e , l i f t up t o r e l e a s e t h e 
c h i p . As shown i n t h e d i a g r a m on t h e 
PROMENADE, 
c h i p s 
must 
be 
p l a c e d i n t h e Z I F w i t h t h e n o t c h e d end o f t h e c h i p on 
t h e 
LEFT. 
The Z I F can a c c e p t b o t h 28 and 2 4 - p i n c h i p s . C h i p s w i t h 
o n l y 
24 
p i n s must be p l a c e d a l l t h e way t o t h e 
RIGHT 
end 
o f 
t h e 
ZIF. 
CAUTION: 
I n s e r t i n g 
t h e 
c h i p 
i n c o r r e c t l y 
c a n 
damage 
i t ! The 
PROMENADE i n c o r p o r a t e s s p e c i a l c i r c u i t r y t o p r o t e c t 
i t s e l f 
f r o m 
i m p r o p e r l y i n s e r t e d EPROMs. U n f o r t u n a t e l y , t h e r e 
i s no 
way 
t o 
p r o t e c t t h e EPROM. 
Remember - n o t c h on 
t h e 
l e f t , 
c h i p 
t o 
t h e 
r i g h t . 


Three LEDs ( l i g h t s ) t e l l t h e s t a t u s o f t h e d e v i c e 
a t 
a 
g l a n c e . 
The g r e e n LED marked "PWR" 
i n d i c a t e s t h a t power i s b e i n g s u p p l i e d 
t o t h e PROMENADE. I t s h o u l d b e s t a y l i t s t e a d i l y as l o n g 
as 
t h e 
computer i s powered on. I f i t dims o r b l i n k s , y o u r 
power 
s u p p l y 
may be o v e r l o a d e d o r on t h e v e r g e 
o f 
f a i l u r e . 
When 
u s i n g 
t h e 
PROMENADE i t ' s b e s t t o u n p l u g any p e r i p h e r a l s 
w h i c h 
draw 
power 
f r o m t h e computer, 
such as a D a t a s e t t e 
o r 
a 
p r i n t e r 
i n t e r f a c e 
c o n n e c t e d t o t h e c a s s e t t e p o r t . N o t e t h a t t h i s p r o b l e m i s due 
t o 
Commodore's power s u p p l y , n o t t h e PROMENADE. I n p a r t i c u l a r , 
t h e 
power s u p p l y i n t h e SX-64 i s b a r e l y a d e q u a t e f o r normal 
use, 
so 
we recommend t h a t y o u do n o t u s e t h e PROMENADE w i t h it. 


The second LED i s a r e d l i g h t marked "SKT". I t i s l i t o n l y 
when 
power i s a c t u a l l y b e i n g s u p p l i e d t o 
t h e 
s o c k e t , 
namely 
d u r i n g 
r e a d i n g o r programming a c h i p . Once a g a i n , t h e 
l i g h t 
s h o u l d 
be 
s t e a d y any t i m e i t i s l i t . The t h i r d LED 
i s y e l l o w 
and 
marked 
" P G M " . 
I t s e r v e s t w o f u n c t i o n s . D u r i n g t h e p r o c e s s o f programming 
a c h i p , i t w i l l be l i t b u t may v a r y i n b r i g h t n e s s as 
programming 
p u l s e s a r e 
a p p l i e d 
t o 
t h e 
c h i p . 
I f any 
t y p e 
o f 
e r r o r 
i s 
e n c o u n t e r e d w h i l e r e a d i n g o r programming a c h i p , t h e y e l l o w l i g h t 
w i l l b e g i n f l a s h i n g and t h e r e d s o c k e t l i g h t w i l l go o u t . 
Common 
e r r o r s i n c l u d e t r y i n g t o p r o g r a m a c h i p t h a t i s damaged o r h a s n ' t 
been c o m p l e t e l y e r a s e d , u s i n g t h e wrong 
c o n t r o l 
o r 
programming 
words 
( s e e 
b e l o w ) , 
o r 
i n s e r t i n g 
t h e 
c h i p 
i n 
t h e 
s o c k e t 
i n c o r r e c t l y . The e r r o r c o n d i t i o n s h o u l d be c l e a r e d 
b e f o r e 
u s i n g 
t h e PROMENADE a g a i n. 


The "SKT" and " P G M " 
LEDs may a l s o l i g h t up and s t a y l i t when 
t h e 
computer i s t u r n e d on 
o r 
RESET, 
o r 
when 
RUN/STOP-RESTORE 
i s 
p r e s s e d . T h i s i s n o r m a l , b u t y o u s h o u l d a v o i d d o i n g any o f 
t h e s e 
t h i n g s w h i l e a c h i p i s i n t h e 
s o c k e t . 
You 
s h o u l d 
a l s o 
a v o i d 
r e m o v i n g o r i n s e r t i n g a c h i p w h i l e e i t h e r o f t h e s e t w o l i g h t s a r e 
on. To e x t i n g u i s h t h e s e l i g h t s and i n i t i a l i z e t h e 
PROMENADE 
f o r 
use, u s e t h e " Z " 
( z e r o ) command 
d e s c r i b e d 
below. 
T h i s 
command 
w i l l a l s o c l e a r o u t an e r r o r c o n d i t i o n ( f l a s h i n g "PGM" 
l i g h t ) . 
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PROMOS 


The p o w e r f u l f e a t u r e s o f t h e PROMENADE 
a r e 
accessed 
t h r o u g h 
a 
s p e c i a l program c a l l e d PROMOS. 
You 
can 
t h i n k 
o f 
PROMOS 
as 
a 
s p e c i a l EPROM programming language. It adds s e v e r a l new 
commands 
t o BASIC t h a t a l l o w y o u t o r e a d 
and 
w r i t e 
EPROMS. 
The 
PROMOS 
commands can a l s o be u s e d f r o m a c o m p a t i b l e machine l a n g u a g e (ML) 
m o n i t o r . The ML m o n i t o r M I C R O M O N i n c l u d e d 
on 
t h e 
p r o g r a m 
d i s k 
w i t h t h i s book i s c o m p a t i b l e w i t h PROMOS, 
as i s HESMON 
( t m ) 
and 


H I M O N ( f r o m t h e PPM V o l . I and 1 1 ) . 


R a t h e r t h a n l e a r n a l l o f t h e PROMOS commands r i g h t now, w e ' l l 
go 
ahead and b u r n o u r f i r s t EPROM u s i n g t h e 
most 
common 
commands. 
W e ' l l e x p l a i n t h e s e commands as we go, and t h e y w i l l be 
a l l 
y o u 
need t o know f o r most o f t h e work i n t h i s book. A 
l a t e r 
c h a p t e r 
on t h e PROMOS commands w i l l c o v e r each command i n more d e t a i l . 


Before we can u s e t h e PROMOS commands, we must l o a d 
and 
e x e c u t e 
t h e PROMOS s o f t w a r e . PROMOS i s s u p p l i e d on t h e d i s k 
accompanying 
t h e PROMENADE. 
B o t h t h e VIC-20 and 
C64 
v e r s i o n s 
a r e 
p r o v i d e d . 
PROMOS i s a l s o a v a i l a b l e on a c a r t r i d g e f o r t h e 
C64 
a l o n g 
w i t h 
t h e HESMON ( t m ) ML m o n i t o r and t h e DOS wedge. T h i s 
c a r t r i d g e 
i s 
a v a i l a b l e d i r e c t l y f r o m CSM. 
I n t h i s c h a p t e r w e ' l l c o v e r j u s t t h e 
d i s k v e r s i o n o f PROMOS. 
The n e x t 
c h a p t e r , 
on 
ML 
m o n i t o r s 
and 
PROMOS, 
w i l l c o v e r how t o u s e t h e PROMOS c a r t r i d g e . 


Use t h e f o l l o w i n g command t o l o a d t h e C64 d i s k v e r s i o n o f PROMOS: 


LOAD "PROMOS*", 
8 


There have been a c o u p l e o f v e r s i o n s o f P R O M O S so f a r , 
b u t 
t h i s 
command w i l l work f o r b o t h o f them ( v e r s i o n 1.1 i s t h e l a t e s t 
as 
o f t h e t i m e t h i s book i s w r i t t e n , 1 1 / 8 5 ) . 
PROMOS 
w i l l 
l o a d 
i n 
l i k e a BASIC program. Now e n t e r 
a 
RUN 
command. 
When 
y o u 
r u n 
PROMOS, i t w i l l copy i t s e l f up t o t h e h i g h end o f t h e BASIC area, 
and p a t c h i t s e l f i n t o t h e BASIC language. You w i l l see t h e PROMOS 
s t a r t - u p message appear 
on 
t h e 
s c r e e n . 
PROMOS 
i s r e a d y 
f o r 
a c t i o n . 
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Okay, once PROMOS i s r u n n i n g w e ' r e r e a d y t o b u r n 
an 
EPROM. 
F o r 
t h i s f i r s t example, w e ' l l s i m p l y make a d i r e c t 
copy 
o f 
a n o t h e r 
EPROM. Most o f t h e p r o j e c t s and examples i n t h i s 
book 
w i l l 
u s e 
t h e same t y p e o f EPROM, 
t h e 
2764 
( 8 K ) . 
W e ' l l 
base 
o u r 
f i r s t 
example on t h a t t y p e o f 
c h i p 
t o o . 
T r y 
t o 
f i n d 
a 
c o m m e r c i a l 
c a r t r i d g e w h i c h has a 2764 c h i p i n i t . T h i s t y p e o f c h i p 
has 
28 
p i n s ( m e t a l l e g s ) ; o t h e r t y p e s o f c h i p s y o u 
e n c o u n t e r 
may 
have 
o n l y 24 p i n s . I f t h e c h i p i n a c a r t r i d g e has 2 8 - p i n s , 
chances a r e 
i t i s a 
2764. 
The 
number 
2764 
s h o u l d 
appear 
on 
t h e 
c h i p 
somewhere, 
a l t h o u g h i t i s o f t e n s u r r o u n d e d b y 
o t h e r 
d i g i t s 
and 
l e t t e r s . F o r 
example, 
one 
c h i p 
we 
came 
a c r o s s 
was 
l a b e l e d 


HN4827646, b u t t h e o n l y i m p o r t a n t p o i n t t o us 
i s t h a t i t does 
have 2764 i n t h e 
name. 
Sometimes 
t h e 
c h i p ' s 
number 
w i l l 
be 
c o v e r e d up b y a p a p e r 1 a b e l . 
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Make s u r e t h e c h i p i s mounted i n a s o c k e t on t h e c a r t r i d g e board. 
If t h e c h i p i s n o t mounted i n a 
s o c k e t , 
y o u 
s h o u l d n ' t 
t r y 
t o 
remove i t . A l t h o u g h i t i s p o s s i b l e t o d e s o l d e r t h e c h i p f r o m 
t h e 
board, i t ' s v e r y easy t o damage t h e c h i p and t h e b o a r d d o i n g 
so. 
I f y o u c a n ' t f i n d a c a r t r i d g e w i t h 
s o c k e t e d 
2764 
i n it, j u s t 
p r a c t i c e on a b l a n k 2764 
and 
s t a n d a r d 
c a r t r i d g e 
b o a r d . 
These 
m a t e r i a l s a r e a v a i l a b l e f r o m CSM. 
Y o u ' l l need t h e s e m a t e r i a l s f o r 
o t h e r p r o j e c t s i n t h i s book, so y o u 
s h o u l d 
have 
some 
on 
hand 
anyway. 


Removing a c h i p f r o m i t s s o c k e t i s p r e t t y s i m p l e , b u t i t s h o u l d 
be done c a r e f u l l y so as n o t t o bend o r b r e a k t h e 
m e t a l 
l e g s . 
A 
s p e c i a l I C p u l l i n g t o o l i s made f o r t h i s j o b , b u t 
y o u 
c a n 
a l s o 
u s e a s m a l l s c r e w d r i v e r t o p r y up t h e c h i p . Work back 
and 
f o r t h 
f r o m one end o f t h e c h i p t o t h e o t h e r u n t i l t h e 
l e g s 
a r e 
f r e e . 
H a n d l e t h e c h i p c a r e f u l l y once i t i s o u t 
o f 
t h e 
s o c k e t . 
A v o i d 
t o u c h i n g t h e p i n s w i t h y o u r f i n g e r s , s i n c e s t a t i c e l e c t r i c i t y c a n 
d e s t r o y a c h i p . You c a n s a f e l y s e t EPROMs on t h e m e t a l s u r f a c e o f 
t h e PROMENADE, 
o r u s e s p e c i a l a n t i s t a t i c foam. 


You s h o u l d a l w a y s i n i t i a l i z e t h e PROMENADE b e f o r e y o u 
i n s e r t 
a 
c h i p i n t o it. Type t h e l e t t e r Z 
and 
h i t 
r e t u r n . 
T h i s 
does 
a 
PROMOS Z e r o command, w h i c h r e s e t s t h e PROMENADE'S s o c k e t . I f t h e 
r e d SKT o r y e l l o w PGM l i g h t was lit, t h e y w i l l be t u r n e d o f f . Now 
y o u may i n s e r t t h e EPROM. 
S i n c e a 2764 has 28 p i n s , a l l y o u 
have 
t o do i s make s u r e t h e c o r r e c t end o f t h e c h i p i s i n t h e 
c o r r e c t 
p l a c e . The end o f t h e EPROM w i t h t h e n o t c h must ALWAYS go i n t h e 
l e f t s i d e o f t h e s o c k e t , t o match t h e d i a g r a m on 
t h e 
PROMENADE. 
The h a n d l e on t h e s o c k e t s h o u l d b e p o i n t i n g up 
when 
y o u 
i n s e r t 
t h e c h i p . F l i p t h e l e v e r down t o l o c k t h e c h i p i n t o t h e s o c k e t . 


3 
To make a c o p y o f t h e c h i p , we w i l l r e a d t h e c o n t e n t s o f t h e c h i p 
i n t o t h e C 6 4 ' s memory and t h e n b u r n t h e 
copy 
back 
o u t 
o n t o 
a 
b l a n k EPROM. The PROMOS command t o r e a d a 2764 c h i p i s : 


The f i r s t c h a r a c t e r i n t h e r e a d 
command 
i s t h e 
E n g l i s h 
pound 
s i g n , f o u n d n e a r t h e u p p e r r i g h t - h a n d c o r n e r o f t h e keyboard. The 
f i r s t p a i r o f numbers i n t h e r e a d command (8192, 
16383) 
s p e c i f y 
t h e a r e a o f t h e C 6 4 ' s memory t o r e a d t h e EPROM memory 
i n t o . 
A l l 
numbers f o r PROMOS must be e n t e r e d i n DECIMAL ( t h e numbers 
g i v e n 
above c o r r e s p o n d t o $2000 and $3FFF, r e s p e c t i v e l y , i n h e x ) . 
The 
a r e a f r o m 8192 t o 16383 i s 8K l o n g , 
t h e 
same 
s i z e 
as 
a 
2764 
EPROM. 
The t h i r d number i n t h e command 
( 0 ) 
s p e c i f i e s 
where . i n 
EPROM memory t o s t a r t r e a d i n g . The memory i n an EPROM 
i s a l w a y s 
numbered i n t e r n a l l y s t a r t i n g a t b y t e 0, r e g a r d l e s s 
o f 
where 
i n 
memory 
t h e 
EPROM 
n o r m a l l y 
r e s i d e s . 
The 
0 
i n t h i s 
command 
s p e c i f i e s t h a t w e ' l l s t a r t r e a d i n g a t t h e v e r y f i r s t b y t e o f 
t h e 
EPROM. 
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The f i n a l number i n t h e r e a d command ( 5 ) i s c a l l e d 
t h e 
C o n t r o l 
Word (CW). T h i s number t e l l s t h e PROMENADE what t y p e o f c h i p 
y o u 
have. It i s v e r y i m p o r t a n t t o use t h e r i g h t CW f o r t h e 
c h i p 
y o u 
a r e t r y i n g t o r e a d . The wrong CW can damage y o u r EPROM! The 
l a s t 
page o f t h e PROMENADE manual l i s t s most 
common 
c h i p 
t y p e s 
and 
t h e i r a s s o c i a t e d CWs. F o r now, a l l y o u need t o know i s t h a t 5 
i s 
t h e c o r r e c t CW f o r a 2764 c h i p . 


When y o u p r e s s RETURN a f t e r t y p i n g t h e r e a d command, t h e r e d 
SKT 
l i g h t w i l l come on b r i e f l y as t h e c h i p i s r e a d . I f a l l goes w e l l , 
t h e r e d l i g h t w i l l go o u t when t h e command i s f i n i s h e d . 
I f t h e 
y e l l o w l i g h t b e g i n s t o f l a s h i n s t e a d , i t means t h a t an e r r o r 
has 
o c c u r r e d . Maybe y o u i n s e r t e d t h e c h i p i n t h e PROMENADE wrong, 
o r 
used t h e wrong CW, 
o r t h e c h i p i s n ' t a 2764. Check a l l 
o f 
t h e s e 
p o s s i b i l i t i e s b e f o r e y o u t r y t o r e a d t h e 
c h i p 
a g a i n . 
Remember, 
d o n ' t j u s t u s e t r i a l and e r r o r when y o u ' r e t r y i n g t o r e a d a c h i p ; 
you c o u l d damage a v a l u a b l e o r i g i n a l EPROM. I f y o u 
do 
e n c o u n t e r 
an e r r o r , i n i t i a l i z e t h e PROMENADE w i t h 
a 
Z 
command 
a g a i n 
t o 
c l e a r t h e f l a s h i n g e r r o r l i g h t . 
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Assuming a l l went w e l l w i t h t h e r e a d command, we c a n t u r n 
a r o u n d 
and w r i t e t h e memory back t o a b l a n k 2764 ( b y b l a n k we mean f u l l y 
e r a s e d - a l l b y t e s s e t t o $FF). We 
c o u l d a l s o save o u t a copy 
o f 
t h e memory t o a d i s k , b u t we w o u l d need an ML m o n i t o r t o do it. 
L a t e r on w e ' l l c o v e r some examples 
o f 
s a v i n g 
EPROM 
memory 
t o 
d i s k . F o r now, l e t ' s j u s t b u r n t h e memory o u t o n t o a 
new 
EPROM. 
I n s e r t a b l a n k 2764 EPROM i n t o t h e PROMENADE, w i t h t h e 
n o t c h 
on 
t h e c h i p t o t h e l e f t as always. Lock t h e h a n d l e down. 
E n t e r 
t h e 
f o l l o w i n g PROMOS command: 
v 


DON'T use t h e l e t t e r s " P I " ; 
use t h e p i k e y on t h e k e y b o a r d ( s h i f t 
up-arrow, n e a r t h e RESTORE k e y ) . You s h o u l d r e c o g n i z e most o f t h e 
o t h e r p a r a m e t e r s i n t h i s command f r o m t h e r e a d command - t h e a r e a 
o f C64 memory t o save o n t o t h e c h i p (8192, 163831, 
t h e 
s t a r t i n g 
address i n t h e c h i p ( 0 ) and t h e CW ( 5 ) . T h i s command has one 
new 
p a r a m e t e r ( 7 ) t h a t i s o n l y used when programming ( w r i t i n g 
t o ) 
a 
c h i p . It i s c a l l e d t h e Program Method Word (PMW) and i t s p e c i f i e s 
t h e p a r t i c u l a r method t o u s e i n programming 
t h e 
c h i p . 
A t 
t h i s 
p o i n t , y o u d o n ' t need t o w o r r y a b o u t t h e d i f f e r e n c e s between 
t h e 
, 
v a r i o u s methods. T h e r e i s no " r i g h t " method t o u s e t o 
p r o g r a m 
a 
c h i p , j u s t recommended methods. U s i n g t h e wrong PMW c a n ' t 
damage 
y o u r c h i p , b u t i t m i g h t n o t p r o g r a m t h e memory o n t o i t r e l i a b l y . 
F o r now, j u s t f o l l o w o u r recommendation and u s e a PMW o f 7. 


When y o u p r e s s RETURN a f t e r t y p i n g t h e command, t h e r e d 
SKT 
and 
y e l l o w PGM l i g h t s s h o u l d come on. Depending on t h e t y p e o f 
c h i p , 
programming can t a k e anywhere f r o m 8 seconds t o s e v e r a l 
m i n u t e s . 
I f no e r r o r s o c c u r , t h e t w o l i g h t s w i l l go 
o f f 
a g a i n 
when 
t h e 
p r o c e s s i s f i n i s h e d . 
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I f an e r r o r o c c u r s d u r i n g t h e 
programming 
p r o c e s s , 
t h e 
y e l l o w 
l i g h t w i l l b e g i n t o f l a s h . The most common e r r o r s 
a r e 
i n s e r t i n g 
t h e c h i p i n c o r r e c t l y i n t h e PROMENADE, u s i n g 
t h e 
wrong 
CW 
and 
t r y i n g 
t o 
p r o g r a m 
a 
c h i p 
t h a t 
i s n ' t 
b l a n k . 
Check 
t h e s e 
p o s s i b i l i t i e s b e f o r e y o u t r y a g a i n . Be s u r e t o u s e t h e Z 
command 
t o i n i t i a l i z e t h e PROMENADE b e f o r e y o u 
t r y 
t o 
program 
a n o t h e r 
c h i p . 


Even i f no e r r o r s a r e r e p o r t e d , i t i s good 
p r a c t i c e 
t o 
v e r i f y 
t h a t t h e c h i p was programmed c o r r e c t l y . F o r now, t h e b e s t way 
t o 
t e s t t h e EPROM w e ' v e j u s t b u r n e d i s t o p u t i t i n t o t h e 
c a r t r i d g e 
we t o o k t h e o r i g i n a l EPROM o u t o f and t r y i t . Be s u r e 
t o 
i n s e r t 
y o u r EPROM copy i n t h e c a r t r i d g e s o c k e t t h e same way t h e o r i g i n a l 
c h i p was - t h e r e i s u s u a l l y a n o t c h o r d o t on t h e s o c k e t o r b o a r d 
t o match t h e n o t c h on t h e c h i p . A l s o make s u r e a l l 
t h e 
p i n s 
o f 
t h e EPROM a r e 
i n s e r t e d 
i n t o 
t h e 
c o r r e s p o n d i n g 
h o l e s 
i n t h e 
s o c k e t . Get t h e p i n s s t a r t e d i n t h e h o l e s 
a1 1 
a r o u n d 
and 
t h e n 
push s t r a i g h t down on t h e EPROM. 


Now t u r n o f f y o u r computer, i n s e r t t h e c a r t r i d g e , 
and 
t u r n 
t h e 
computer back on. Most c a r t r i d g e s s t a r t t h e m s e l v e s 
a u t o m a t i c a l l y 
when t h e power i s t u r n e d on. You s h o u l d check t h a t t h e 
c a r t r i d g e 
p e r f o r m s e x a c t l y t h e same as t h e o r i g i n a l d i d b y g o i n g t h r o u g h 
a 
c o u p l e o f game s c r e e n s o r menu o p t i o n s , as t h e c a s e 
may 
be. 
I f 
t h e c a r t r i d g e does n o t s t a r t up as u s u a l , t u r n o f f 
t h e 
computer 
i m m e d i a t e l y ! You may have i n s e r t e d t h e 
EPROM 
i n t h e 
c a r t r i d g e 
i m p r o p e r l y o r made some o t h e r m i s t a k e . I f y o u 
c a n ' t 
f i g u r e 
o u t 
what went wrong, t r y m a k i n g a n o t h e r copy 
f r o m 
t h e 
b e g i n n i n g - 
l o a d PROMOS, 
r e a d i n t h e o r i g i n a l c h i p , e t c . 
Chances 
a r e , 
y o u r 
EPROM copy w i l l work p e r f e c t l y t h e f i r s t t i m e i f y o u ' v e 
f o l l o w e d 
i n s t r u c t i o n s . C o n g r a t u l a t i o n s - y o u ' v e 
j u s t 
b u r n e d 
y o u r 
f i r s t 
EPROM! 


T h a t was f u n , w a s n ' t i t ? What c a n we do f o r an e n c o r e ? W e l l , once 
y o u ' v e v e r i f i e d t h a t y o u r EPROM c o p y works, 
y o u 
p r o b a b l y 
d o n ' t 
need t o keep i t around. T h i s b r i n g s 
u s 
t o 
e r a s i n g 
EPROMs. 
To 
e r a s e t h e copy EPROM, 
y o u ' l l 
need 
a 
c o m m e r c i a l 
EPROM 
e r a s e r 
( u n l e s s y o u want t o s e t t h e EPROM i n t h e 
sun 
f o r 
a 
c o u p l e 
o f 
weeks). Most common t y p e s o f EPROMs, i n c l u d i n g t h e 2764 
we 
used 
i n t h i s example, a r e e r a s e d 
u s i n g 
a 
p a r t i c u l a r 
w a v e l e n g t h 
o f 
u l t r a v i o l e t (UV) l i g h t . S u n l i g h t c o n t a i n s some o f t h i s p a r t i c u l a r 
UV l i g h t , w h i c h i s why i t w i l l e r a s e an EPROM e v e n t u a l l y i f g i v e n 
enough t i m e . 


There a r e many c o m m e r c i a l EPROM e r a s e r s on t h e m a r k e t t o d a y . Some 
w i l l e r a s e 10 EPROMS a t a t i m e i n o n l y a f e w 
m i n u t e s , 
b u t 
t h e y 
w i l l 
c o s t 
y o u 
more 
t h a n 
y o u r 
PROMENADE 
d i d ! 
T h e r e 
i s an 
i n e x p e n s i v e a l t e r n a t i v e t h a t w i l l s u i t 
most 
u s e r s ' 
needs. 
The 


DATARASE, a v a i l a b l e f r o m CSM, 
w i l l e r a s e t w o EPROMS i n 10 m i n u t e s 
o r l e s s . The DATARASE can 
e r a s e 
a l l 
U V - e r a s a b l e 
EPROM 
t y p e s , 
w h i c h i n c l u d e s a l l t h e EPROMs i n t h i s book. I f y o u d o n ' t have one 
a l r e a d y , y o u s h o u l d g e t a DATARASE o r o t h e r t y p e o f EPROM e r a s e r . 
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B e f o r e y o u i n s e r t y o u r EPROM i n t o t h e e r a s e r , make s u r e t h a t 
t h e 
q u a r t z 
window 
on 
t o p 
o f 
t h e 
EPROM 
i s 
c l e a n . 
Sometimes 
f i n g e r p r i n t s o r gum f r o m l a b e l s w i l l c l o u d t h e window. 
T h i s 
can 
r e s u l t i n p a r t i a l e r a s u r e o f t h e EPROM o r p r o l o n g t h e t i m e needed 
t o e r a s e 
t h e 
EPROM. 
O t h e r 
f a c t o r s 
i n v o l v e d 
i n t h e 
e r a s i n g 
process, such as t h e e x a c t w a v e l e n g t h and 
i n t e n s i t y 
o f 
t h e 
UV 
l i g h t , a r e d i s c u s s e d i n t h e l a s t c h a p t e r . W i t h a l l o f 
t h e 
o t h e r 
f a c t o r s t h e same, e x p o s u r e t i m e i s t h e most i m p o r t a n t 
f a c t o r 
i n 
e r a s i n g EPROMs. 


E r a s u r e t i m e s w i l l v a r y f r o m one m a n u f a c t u r e r 
t o 
a n o t h e r , 
even 
w i t h t h e same t y p e o f c h i p . Your 
e x p e r i e n c e 
w i t h 
a 
p a r t i c u l a r 
b r a n d o f c h i p i s t h e b e s t g u i d e . S t a r t w i t h an e r a s u r e t i m e o f 10 
m i n u t e s . I f t h a t seems t o work 
f o r 
y o u r 
t y p e 
o f 
c h i p s , 
t r y 
r e d u c i n g t h e t i m e a b i t . I f y o u a r e n ' t g e t t i n g 
c o m p l e t e 
e r a s u r e 
( a l l $FF b y t e s ) , i n c r e a s e t h e t i m e a l i t t l e . A good h a b i t t o 
g e t 
i n t o i s s e t t i n g a t i m e r t o r e m i n d y o u when t o remove 
t h e 
EPROM. 
A l t h o u g h o v e r e x p o s i n g t h e EPROM a f e w t i m e s p r o b a b l y 
w o n ' t 
h u r t 
it, i t can c u t down on t h e l i f e o f t h e c h i p e v e n t u a l l y . 


W e l l , t h i s b r i n g s u s t o t h e end of o u r f i r s t 
l e s s o n 
i n b u r n i n g 
EPROMs. I f y o u ' r e i t c h i n g t o t r y a r e a l p r o j e c t , w e ' v e 
g o t 
some 
g r e a t ones 1 i n e d up f o r y o u 1 a t e r on 
i n t h e 
book. 
B e f o r e 
y o u 
t a c k l e them, t h o u g h , t h e r e ' s a f e w more t h i n g s y o u 
s h o u l d 
know. 
The n e x t f e w c h a p t e r s w i l l c o v e r t h e s e t o p i c s . 
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PROUOS 


T h i s c h a p t e r i s i n t e n d e d as a r e f e r e n c e t o PROMOS and t h e 
PROMOS 
commands. 
I n t h e 
o t h e r 
c h a p t e r s , 
we 
a l w a y s 
g i v e 
y o u 
t h e 
a p p r o p r i a t e PROMOS commands f o r w h a t e v e r y o u a r e d o i n g . 
However, 
you may want t o r e f e r t o t h i s c h a p t e r f r o m t i m e 
t o 
t i m e 
f o r 
a 
more c o m p l e t e e x p l a n a t i o n o f some p o i n t . Y o u ' l l 
a l s o 
f i n d 
t h i s 
c h a p t e r v a l u a b l e when y o u ' r e w o r k i n g on p r o j e c t s t h a t a r e n ' t from 
t h i s book. F o r i n s t a n c e , i f y o u e n c o u n t e r a 
new 
t y p e 
of 
c h i p , 
t h i s c h a p t e r c a n h e l p y o u d e r i v e t h e c o r r e c t c o n t r o l w o r d t o 
u s e 
w i t h it. O r y o u may want t o r e l o c a t e PROMOS t o 
a n o t h e r 
l o c a t i o n 
because o f a c o n f l i c t w i t h t h e f i l e y o u a r e b u r n i n g t o EPROM. If 
y o u want t o e x p e r i m e n t w i t h t h e PROMOS f i l e commands, y o u ' l l f i n d 
them c o v e r e d 
i n t h i s 
c h a p t e r 
even 
t h o u g h 
t h e y 
a r e n ' t 
used 
e l s e w h e r e i n t h e book. We 
s u g g e s t t h a t y o u l o o k o v e r t h i s c h a p t e r 
t o see w h a t ! s c o v e r e d h e r e , and t h e n come back 
t o i t when 
t h e 
need a r i s e s . 


L O A D I N G PROHOS 


I n o r d e r t o u s e t h e f e a t u r e s o f t h e PROMENADE, y o u must 
u s e 
t h e 
PROMOS s o f t w a r e t h a t i s s u p p l i e d w i t h t h e PROMENADE. To s t a r t 
up 
PROMOS, 
p u t t h e PROMOS d i s k i n t h e d r i v e and t y p e : 


LOAD "PROMOS*", 
8 
RUN 


PROMOS w i l l r e s p o n d w i t h i t s s t a r t u p 
message. 
I n most 
cases, 
t h a t ' s a l l y o u need t o do t o g e t s t a r t e d w i t h PROMOS. 


The s t a r t u p message d i s p l a y s t h e PROMOS v e r s i o n number. As of t.he 
t i m e t h i s i s w r i t t e n ( 1 1 / 8 5 ) t h e l a t e s t v e r s i o n i s 1.1. 
You 
may 
have v e r s i o n 1.0 i n s t e a d , i n w h i c h c a s e y o u 
s h o u l d 
c o n t a c t 
CSM 
f o r an u p d a t e . A l l r e f e r e n c e s i n t h i s book 
t o 
PROMOS 
r e f e r 
t o 
v e r s i o n 1 .l. The improvements i n v e r s i o n 
1 .I o v e r 
v e r s i o n 
1.0 
a r e : 


A) A "Z" command i s done a u t o m a t i c a l l y when PROMOS i s e n a b l e d . 
B ) 27512 EPROMS c a n be programmed. 
C ) The t i m i n g m a r g i n f o r MCM68764 i s i m p r o v e d . 
D) A bug i n programming t h e l a s t b y t e o f 2 7 2 5 6 ' s i s c o r r e c t e d . 
E) Some o f 
t h e 
bugs 
i n t h e 
f i l e commands 
may 
have 
been 
c o r r e c t e d . 


O n l y one o f t h e s e changes w i l l 
a f f e c t 
us 
i n t h i s 
book. 
When 
PROMOS 1.1 i s e n a b l e d , i t a u t o m a t i c a l l y does a " Z " command. 
W i t h 
v e r s i o n 1.0, 
y o u must do a "Z" command y o u r s e l f BEFORE 
i n s e r t i n g 
a c h i p i n t h e s o c k e t . 
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PROMOS i s a machine l a n g u a g e p r o g r a m w h i c h c a n be l o c a t e d 
a l m o s t 
anywhere i n memory. When y o u 
l o a d 
and 
r u n 
PROMOS, 
i t c o p i e s 
i t s e l f up t o . t h e end o f t h e BASIC a r e a 
i n memory. 
The 
end 
of 
BASIC i s i n d i c a t e d 
b y 
a 
p o i n t e r 
s t o r e d 
i n l o c a t i o n s 
55-56 
( $ 3 7 - $ 3 8 ) . T h i s p o i n t e r i s s t o r e d i n s t a n d a r d 
l o w 
b y t e / 
h i g h 
b y t e o r d e r . A f t e r PROMOS c o p i e s i t s e l f up b e l o w t h e end of BASIC, 
i t s e t s t h e p o i n t e r down so t h a t t h e BASIC a r e a 
now 
ends 
where 
PROMOS b e g i n s . T h i s p r o t e c t s PROMOS f r o m b e i n g w i p e d o u t b y BASIC 
v a r i a b l e s . 


You c a n u s e 
t h i s 
" a u t o - r e l o c a t i n g " 
f e a t u r e 
t o 
c o n t r o l 
where 
PROMOS 
r e s i d e s . 
PROMOS 
n o r m a l l y 
p u t s 
i t s e l f 
a t 
$96DO-9FFF 


(38608-40959). Sometimes t h i s w i l l c o n f l i c t w i t h t h e p r o g r a m 
y o u 
w i s h t o " b u r n " o n t o EPROM. F o r i n s t a n c e , most s t a n d a r d c a r t r i d g e s 
r e s i d e a t $8000-9FFF (32768-40959), 
w h i c h 
i n c l u d e s 
t h e 
normal 
PROMOS a r e a . A l t h o u g h a p r o g r a m does n o t have t o b e " b u r n e d " o n t o 
EPROM f r o m t h e same l o c a t i o n i n memory i t n o r m a l l y 
r e s i d e s 
a t , 
t h a t ' s u s u a l l y t h e most c o n v e n i e n t way t o do it. If y o u w i s h , y o u 
can f o r c e PROMOS t o r e l o c a t e i t s e l f a l m o s t anywhere 
b y 
c h a n g i n g 
t h e end o f BASIC p o i n t e r b e f o r e y o u r u n PROMOS. F o r 
example, if 
y o u a l t e r t h e 
o i n t e r a t 55-56 so BASIC ends 
a t 
$8000 
(327681, 


PROMOS w i l l r e ! 
o c a t e i t s e l f b e l o w t h i s a d d r e s s . T h i s 
w i l l 
l e a v e 
t h e a r e a above $8000 f r e e f o r y o u r c a r t r i d g e f i l e . 


To change t h e end o f BASIC, s i m p l y poke t h e l o w b y t e of 
t h e 
new 
a d d r e s s i n t o l o c a t i o n 55 and t h e h i g h b y t e i n t o l o c a t i o n 56. 
F o r 
example, 
t o 
s e t 
t h e 
p o i n t e r 
t o 
$8000, 
u s e 
POKE 55,O 
and 
POKE 56,128 
( s i n c e $80=128). Then l o a d and r u n PROMOS as 
u s u a l . 
PROMOS w i l l r e l o c a t e i t s e l f t o t h e $76DO-7FFF a r e a (30416-32767). 
A n o t h e r c o n v e n i e n t p l a c e t o l o c a t e PROMOS 
i s j u s t 
b e l o w 
$CCOO 


( 5 2 2 2 4 ) . T h i s i s a good p l a c e f o r PROMOS because t h e 
a r e a 
above 


$CCOO i s where t h e DOS WEDGE n o r m a l l y r e s i d e s . 
C o n t r a r y 
t o 
t h e 
PROMENADE manual, PROMOS and t h e wedge are c o m p a t i b l e . To s e t t h e 
end o f BASIC t o 
$CCOO, 
u s e 
POKE 55,O 
and 
POKE 56,204 
( s i n c e 


$CC=204). PROMOS w i l l r e l o c a t e 
i t s e l f 
t o 
t h e 
$C2DO-CBFF 
a r e a 
(49872-52223). When y o u l o c a t e PROMOS 
h e r e 
( o r 
anywhere 
a b o v e . 


$A000=40960), y o u s h o u l d s e t t h e end o f BASIC p o i n t e r 
back 
down 
after r u n n i n g PROMOS. 
S e t t h e p o i n t e r t o a v a l u e i n t h e 
r e g u l a r 
BASIC a r e a so t h a t BASIC w i l l be 
a b l e 
t o 
s t o r e 
i t s v a r i a b l e s 
n o r m a l l y . Use POKE 55,O 
and POKE 56,160 t o s e t t h e p o i n t e r t o i t s 
normal v a l u e ( $ A 0 0 0 ) . One o t h e r p l a c e 
t o 
p u t 
PROMOS 
i s w o r t h 
m e n t i o n i n g . I f y o u u s e POKE 55,192 and POKE 56,17 
PROMOS w i l l p u t 
i t s e l f 
a t 
t h e 
l o w e s t 
p o s s i b l e 
p l a c e 
i n memory, 
$0890-1 lCO 


(2192-4544). 


A f t e r b e i n g r e l o c a t e d , PROMOS e n a b l e s i t s e l f b y p a t c h i n g i n t o t h e 
I R Q v e c t o r a t 
$0314-15 
and 
t h e 
KERNAL 
v e c t o r s 
a t 
$031A-33. 


Through t h e s e a l t e r e d v e c t o r s i t i n t e r c e p t s a l l r e f e r e n c e s t o i t s 
own commands. H i t t i n g RUN/STOP-RESTORE w i l l r e p l a c e t h e s e v e c t o r s 
w i t h t h e i r normal v a l u e s and d i s a b l e PROMOS. 
U s i n g most 
m o n i t o r s 
w i l l a l s o 
a l t e r 
t h e s e 
v e c t o r s . 
To 
r e - e n a b l e 
PROMOS 
w i t h o u t 
r e l o a d i n g i t f r o m d i s k , u s e SYS 668 (G $029D). PROMOS p u t s a jump 
command down a t t h i s a d d r e s s ( i n an unused a r e a ) t h a t 
p o i n t s 
t o 
t h e s t a r t o f i t s own code. I f t h i s p o i n t e r g e t s w i p e d o u t , y o u ' l l 
have t o r e l o a d PROMOS f r o m d i s k . 
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There i s an a l t e r n a t i v e t o l o a d i n g PROMOS f r o m 
d i s k . 
A 
s p e c i a l 
c a r t r i d g e i s a v a i l a b l e f r o m CSM 
t h a t 
c o n t a i n s 
t h e 
ML 
m o n i t o r 
HESMON 64 2.0 
(TM) and t h e DOS WEDGE 5.1, 
as w e l l as PROMOS 
1.1. 
A l l t h i s i s i n c l u d e d on one c a r t r i d g e f o r a b o u t t h e same p r i c e as 
a HESMON c a r t r i d g e a l o n e . A HESMON manual i s i n c l u d e d 
t o o . 
W i t h 
t h i s c a r t r i d g e y o u ' l l a l w a y s have t h e s e t h r e e e s s e n t i a l u t i l i t i e s 
a v a i l a b l e a t a moment's n o t i c e . 
The 
c a r t r i d g e 
r e s i d e s 
i n t h e 
u s u a l 32768-40959 ($8000-9FFF) a r e a f o r 
c a r t r i d g e s . 
T h i s 
i s a 
s l i g h t i n c o n v e n i e n c e i n some cases, b u t t h e i n s t a n t 
a v a i l a b i 1 i t y 
of HESMON, PROMOS and t h e wedge more t h a n make up f o r i t . If y o u 
a r e i n t o EPROM programming and were c o n s i d e r i n g b u y i n g a 
r e g u l a r 
HESMON c a r t r i d g e , b y a l l means g e t t h i s c a r t r i d g e i n s t e a d . 


PROMOS COMMANDS 


L e t ' s l o o k a t a f e w o f t h e PROMOS commands now. 
T h i s 
i s n o t 
a 
c o m p l e t e l i s t o f t h e commands t h a t PROMOS s u p p o r t s , b u t t h e s e a r e 
t h e ones w e ' l l u s e i n t h e r e s t o f t h e book. 


I n i t i a l i z a t i o n command 


Z - T h i s command z e r o s ( i n i t i a l i z e s ) t h e PROMENADE. Must be 
used 
i f y o u want t o i n s e r t a c h i p i n t h e PROMENADE and 
t h e 
"SKT" 
o r 


"PGM" 
l i g h t s a r e l i t . A l s o c l e a r s an 
e r r o r 
c o n d i t i o n 
( f l a s h i n g 


" P G M " 
l i g h t ) . 
T h i s 
command 
w i l l 
b r i n g 
a l l 
o f 
p i n s 
i n t h e 


PROMENADE'S Z I F s o c k e t t o 0 v o l t s . T h i s i n s u r e s t h a t t h e r e 
w o n ' t 
be any p r o b l e m s when c h a n g i n g EPROMs. 


D i r e c t access commands 


These a r e t h e o n l y commands t h a t w e ' l l u s e t o 
p r o g r a m 
c h i p s 
i n 
t h i s book. W i t h t h e s e commands y o u must s p e c i f y a 
b e g i n n i n g 
and 
e n d i n g l o c a t i o n i n t h e C - 6 4 ' s memory 
f o r 
y o u r 
i n f o r m a t i o n , 
.as 


w e l l as a b e g i n n i n g l o c a t i o n on t h e c h i p . B y t e s 
on 
a 
c h i p 
a r e 
a l w a y s numbered s t a r t i n g f r o m 0, r e g a r d l e s s of 
where 
i n memory 
t h e c h i p w i l l u l t i m a t e l y r e s i d e . A l l a d d r e s s e s must be 
s p e c i f i e d 
i n DECIMAL f o r PROMOS. 


f s t a r t addr, end addr, c h i p s t a r t addr, CW - T h i s 
command 
r e a d s 
b y t e s d i r e c t l y f r o m t h e c h i p , s t a r t i n g a t t h e c h i p s t a r t 
a d d r e s s 
g i v e n . The b y t e s a r e s t o r e d i n t h e a r e a of C64 
memory 
s p e c i f i e d 
by t h e s t a r t and end a d d r e s s e s . The " C W " 
t e l l s t h e PROMENADE what 
t y p e o f EPROM i s b e i n g r e a d ( s e e b e l o w ) . 


P I s t a r t addr, end addr, c h i p s t a r t i n g addr, CW, 
PMW - T h i s 
command programs d a t a o n t o a c h i p f r o m t h e 
a r e a 
of 
C64 
memory 
s p e c i f i e d b y t h e s t a r t and end addresses. The d a t a 
i s p u t 
o n t o 
t h e c h i p b e g i n n i n g a t t h e 
c h i p 
s t a r t i n g 
a d d r e s s 
y o u 
s p e c i f y . 
S i n c e o u r p r i n t e r d o e s n ' t have t h e Greek l e t t e r p i , w e ' l l u s e t h e 
l e t t e r s P I t o s t a n d f o r i t t h r o u g h o u t t h e book. Do n o t 
t y p e 
t h e 
l e t t e r s P I y o u r s e l f ; u s e t h e p i symbol on t h e 
k e y b o a r d 
( s h i f t e d 
up-arrow, 
n e x t t o RESTORE). The " C W " 
t e l l s 
t h e 
PROMENADE 
what 
t y p e o f EPROM i s b e i n g programmed. The "PMW" 
s p e c i f i e s t h e method 
t o u s e i n programming t h e c h i p ( s e e b e l o w ) . 
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CONTROL WORDS (CWs) 


A l m o s t a l l PROMOS commands r e q u i r e t h e 
u s e 
of 
a 
CONTROL 
WORD 


(CW). The CW i s a 
number 
between 
0 
and 
255 
t h a t 
t e l l s 
t h e 
PROMENADE how t o access t h e c h i p c o r r e c t l y . Each t y p e o f c h i p has 
a s p e c i f i c CW w h i c h must be 
used. 
Using 
an 
i n c o r r e c t 
CW 
can 
damage your EPROM!! 
The a p p e n d i x c o n t a i n s a l i s t o f 
t h e 
CW 
f o r 
many common c h i p t y p e s . T h i s l i s t i s u p d a t e d 
p e r i o d i c a l l y . 
The 
most c u r r e n t v e r s i o n o f t h e l i s t may be o b t a i n e d 
b y 
w r i t i n g 
t o 
CSM. 
P l e a s e e n c l o s e a s e l f - a d d r e s s e d , stamped e n v e l o p e and a n o t e 
e x p l a i n i n g t h a t y o u want t h e l a t e s t PROMOS CW 
l i s t . 
Most 
c h i p s 
y o u a r e l i k e l y t o e n c o u n t e r a r e a l r e a d y on t h e l i s t ( a s 
a r e 
a l l 
c h i p s used i n t h i s b o o k ) . 


Even t h o u g h t h e CW must be i n d e c i m a l f o r 
a l l 
PROMOS 
commands, 
t h e e a s i e s t way t o a n a l y z e i t i s t o work i n hex. The CW i s always 
between 0 and 255 because i t c o n s i s t s o f a s i n g l e b y t e . T h i s b y t e 
i s made up o f f o u r p a r t s , each o f w h i c h c o n t r i b u t e s two 
b i t s 
t o 
t h e CW ( s e e f i g u r e 3 - 1 ) . 
The b i t s o f t h e CW a r e numbered s t a r t i n g 
a t b i t 0 on t h e r i g h t end ( l e a s t s i g n i f i c a n t b i t ) . The 
r i g h t m o s t 
two 
b i t s 
( b i t s 
0 - 1 ) 
c o n t r o l 
t h e 
v o l t a g e 
l e v e l 
used 
when 
programming t h e c h i p . F o u r v o l t a g e l e v e l s 
a r e 
a v a i l a b l e , 
w h i c h 
a l l o w s a l a r g e o f number o f d i f f e r e n t c h i p s t o be programmed. 


B i t s 2-3 o f t h e CW c o n t r o l w h i c h p i n o f t h e PROMENADE 
socket 
t o 
a p p l y t h e programming v o l t a g e t o ( V p p ) . T h i s i s t h e same 
as 
t h e 


c h i p ' s p i n number f o r 2 8 - p i n c h i p s . F o r 2 4 - p i n c h i p s , t h e 
c h i p ' s 
p i n number w i l l be lower t h a n t h e PROMENADE'S 
s o c k e t 
number 
b y 
t w o s i n c e 2 4 - p i n c h i p s a r e i n s e r t e d 
i n t h e 
r i g h t 
end 
o f 
t h e 
s o c k e t . P i n 1 o f a 24-pin 
c h i p 
c o r r e s p o n d s 
t o 
p i n 
3 
of 
t h e 
PROMENADE socket, and so on. B i t s 4-5 o f t h e CW c o n t r o l w h i c h p i n 
of t h e s o c k e t s h o u l d be used f o r t h e 
programming 
e n a b l e 
s i g n a l 


(PGM). T h i s l i n e c o n t r o l s t h e l e n g t h o f 
t h e 
programming 
p u l s e . 
F i n a l l y , b i t s 6-7 d e t e r m i n e how p i n 20 
o f 
t h e 
s o c k e t 
w i l l 
be 
used. B i t 7 s p e c i f i e s w h e t h e r p i n 20 (CE) w i l l be s e t h i g h o r l o w 
n o r m a l l y . B i t 6 d e t e r m i n e s w h e t h e r t h i s p i n w i l l be l e f t a l o n e o r 
i n v e r t e d d u r i n g a r e a d o p e r a t i o n . 


i g u r e 4-1 summarizes t h e CW f o r m a t . To c r e a t e y o u r own custom CW 
o r a c h i p 
t h a t 
i s n ' t 
l i s t e d , 
s e l e c t 
one 
o p t i o n 
f r o m 
each 


a t e g o r y ( b i t s 6 & 7 a r e s e p a r a t e 
c a t e g o r i e s ) . 
W r i t e 
down 
t h e 
i t s c o r r e s p o n d i n g t o y o u r c h o i c e s ( i n o r d e r ! ) and 
t h e n 
c o n v e r t 
he r e s u l t i n g 8 b i t number t o 
d e c i m a l . 
T h e r e ' s 
a n o t h e r 
method 
w h i c h 
many 
p e o p l e 
w i l l 
f i n d 
e a s i e r . 
N e x t 
t o 
each 
b i t o r 
c o m b i n a t i o n of b i t s i s a number i n p a r e n t h e s e s . 
T h i s 
g i v e s 
t h e 
d e c i m a l v a l u e c o n t r i b u t e d t o t h e CW when t h a t 
p a r t i c u l a r 
o p t i o n 
i s chosen. To c r e a t e a custom 
CW, 
s i m p l y 
add 
up 
t h e 
d e c i m a l 
numbers o f t h e o p t i o n s y o u w i s h t o s e l e c t . 


To b r e a k down a p a r t i c u l a r CW i n t o i t s component o p t i o n s , c o n v e r t 
t h e CW t o b i n a r y and l o o k up t h e o p t i o n s s e p a r a t e l y . A n o t h e r 
way 
uses t h e d e c i m a l f o r m o f t h e CW. 
Go down t h e l i s t s t a r t i n g 
w i t h 
t h e f i r s t c a t e g o r y ( b i t 7 ) . Out o f t h e c h o i c e s i n t h e 
c a t e g o r y , 
s u b t r a c t t h e h i g h e s t p o s s i b l e d e c i m a l number 
( w h i c h 
may 
be 
0 ) 


from t h e CW. The number y o u s u b t r a c t w i l l t e l l y o u 
w h i c h 
o p t i o n 
i n t h a t c a t e g o r y was s p e c i f i e d b y t h e CW. 
Take t h e r e s u l t o f 
t h e 
s u b t r a c t i o n and go on t o t h e n e x t c a t e g o r y . 
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F i g u r e 4-1: 
CONTROL WORD (CW) FORMAT 


Bits 7-6 - Pin 20 Level (CE) 


Bit 7 
Normal level 
O 7 


Bit 6 
Action on read 
00 change 
1 (64) 
Invert level 


Bits 5-4 
PGM Pin Select 
n 
P 1 n 2 1 


O l ( 1 6 ) 
P i n 2 2 
10 (32) 
Pin 20 


l l ( 4 8 ) 
None 


Bits 3-2 
Vpp Pin Select 
mJ77n 
Pin 22 


01 
( 4 ) 
Pin 1 
10 ( 8 ) 
Pin 23 
1 1 (12) 
Pin 1 held LOW 


Bits 1-0 
Voltage Select 
mJ77n m 
1 
ts 


01 
( 1 ) 
21 


10 ( 2 ) 
12.5 
1 1 
( 3 ) 
5 


Note: All pin numbers refer to the 
PROMENADE socket. Subtract 2 from 
the number given to obtain the 
corresponding pin for 24-pin chips. 


F i g u r e 4-2: 
PROGRAM METHOD WORD (PMW) FORMAT 


Bit 5 
File Write Protection 
Not protected 
1 (32) 
Write protected 


Bit 4 
File Relocatability 
rn Relocatabl e 


Program Method 
Bits 3-0 
Pulse length Max. time 


Standard 
0 0 0 0 ( 0 ) 
6 m s . 
- 


01 
( 1 ) 
12 
- 


10 ( 2 ) 
24 
- 


1 1 
(3) 
4 8 
- 


Intelligent #1 
01 0 0 ( 4 ) 
.1 ms. & up 
12 ms. 
01 
( 5 ) 
same 
25 
10 ( 6 ) 
same 
50 
1 1 
( 7 ) 
same 
100 


Intelligent #2 
10 0 0 ( 8 ) 
0.25 ms. 
75 ms. 


01 
(9) 
0.5 
same 


10 (10) 
1.0 
same 


l l ( 1 1 ) 
2.0 
same 


Intelligent #3 
1 1 0 0 (12) 
0.25 ms. 
100 ms. 


O l ( 1 3 ) 
0.5 
same 


1 0 (14) 
1.0 
same 
1 1 (15) 
2.0 
same 
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PROGRAM METHOD WORDS (PUWs) 


The 
PROGRAM 
METHOD 
WORD 
(PMW) 
i s o n l y 
used 
when 
y o u ' r e 
programming a c h i p . I t s m a i n f u n c t i o n i s t o s p e c i f y t h e a l g o r i t h m 
(method) used t o p r o g r a m and v e r i f y t h e c h i p . F i g u r e 4-2 
d e t a i l s 
t h e PMW f o r m a t . B i t s 
3-2 
o f 
t h e 
PMW 
s e l e c t 
t h e 
programming 
method. B i t s 1 - 0 s e l e c t t h e 
programming 
p u l s e 
l e n g t h 
and 
t h e 
maximum programming t i m e p e r b y t e . The PMW i s n o t as c r i t i c a l 
as 
t h e CW - t h e r e i s no " r i g h t " PMW f o r a c h i p , a l t h o u g h 
some 
PMWs 


may g i v e more r e l i a b l e r e s u l t s t h a n o t h e r s w i t h 
t h e 
same 
c h i p . 
The PMW w i l l a f f e c t how l o n g i t t a k e s t o p r o g r a m t h e 
c h i p . 
T h i s 
w i l l a l s o depend on t h e s i z e o f t h e c h i p 
and 
t h e 
m a n u f a c t u r e r . 
The s t a n d a r d programming method i s t h e most 
r e l i a b l e 
b u t 
t a k e s 
t h e l o n g e s t ( a b o u t 7 m i n u t e s f o r 8 K ) . The i n t e l l i g e n t methods a r e 
much q u i c k e r 
and 
s t i l l 
q u i t e 
r e l i a b l e 
f o r 
most 
c h i p s . 
The 
i n t e l l i g e n t methods r a n k i n r e l i a b l i l i t y f r o m #3 (most 
r e l i a b l e ) 
t o #1 
( l e a s t 
r e l i a b l e 
b u t 
f a s t e s t ) . 
I f y o u 
have 
t r o u b l e 
programming a c h i p , t r y r e v e r t i n g t o t h e s t a n d a r d method. 


B i t s 4 & 5 o f 
t h e 
PMW 
a r e 
o n l y 
used 
w i t h 
t h e 
PROMOS 
f i l e 
commands. B i t 4 c o n t r o l s w h e t h e r t h e 
f i l e 
w i l l 
be 
r e l o c a t a b l e 
when l o a d e d back i n f r o m t h e EPROM. 
The 
s h i f t - S 
(SAVE) 
command 
uses t h i s b i t t o t o make n o n r e l o c a t a b l e 
f i l e s . 
B i t 
5 
c o n t r o l s 
w h e t h e r t h e f i l e i s w r i t e p r o t e c t e d o r n o t . W r i t e p r o t e c t i n g y o u r 
f i l e s i s g e n e r a l l y a good i d e a . C r e a t i n g o r a n a l y z i n g a 
PMW 
can 
be done t h e same way we showed y o u f o r a CW. 


PROHOS F I L E COMMANDS 


Most o f t h e PROMOS f i l e commands a r e 
s i m p l y 
e x t e n s i o n s 
of 
t h e 
s t a n d a r d BASIC f i l e commands (SAVE, LOAD, e t c . ) . 
These 
commands 
a l l o w y o u t o t r e a t t h e EPROM ( o r o t h e r c h i p ) l i k e a 
d i s k 
d r i v e , 
c o m p l e t e w i t h d i r e c t o r y . 
Most 
PROMOS 
f i l e commands 
a r e 
v e r y 
s i m i l a r t o t h e 
c o r r e s p o n d i n g 
d i s k 
commands, 
e x c e p t 
t h a t 
t h e 
PROMENADE i s accessed as d e v i c e 16. G e n e r a l l y , y o u can 
save 
and 
l o a d program f i l e s and d a t a f i l e s as 
u s u a l . 
However, 
y o u 
must 
e r a s e t h e e n t i r e c h i p 
t o 
s c r a t c h , 
r e p l a c e 
o r 
rename 
a 
f i l e 
( e x c e p t w i t h EEPROMS). 


We have n o t used any PROMOS f i l e commands i n t h e 
r e s t 
o f 
t h i s 
book. We a r e c o v e r i n g them 
i n t h i s 
c h a p t e r 
f o r 
t h e 
sake 
of 
c o m p l e t e n e s s o n l y . We f e e l t h a t t h e s e commands j u s t 
a r e n ' t 
t h a t 
u s e f u l when y o u come r i g h t down t o i t . N o t o n l y 
t h a t , 
b u t 
t h e y 
may n o t be e n t i r e l y r e l i a b l e e i t h e r . We've p o i n t e d 
o u t 
some 
of 
t h e p o t e n t i a l p r o b l e m s 
b e l o w . 
O v e r a l l , 
r a t h e r 
t h a n 
c r e a t e 
a 
d i r e c t o r y on a c h i p w i t h PROMOS, 
we p r e f e r t o u s e o u r 
MENU MAKER 
p r o g r a m t o c r e a t e a c a r t r i d g e w i t h a menu. 
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One d i s a d v a n t a g e when u s i n g 
PROMOS 
f i l e s 
i s t h a t 
t h e 
PROMOS 
s o f t w a r e must be l o a d e d and r u n b e f o r e y o u c a n access 
any 
f i l e s 
on t h e c h i p ( o f c o u r s e , t h e PROMENADE must be 
p l u g g e d 
i n t o o ) . 
H a v i n g 
t o 
l o a d 
PROMOS 
f r o m 
d i s k 
seems 
t o 
c a n c e l 
o u t 
t h e 
c o n v e n i e n c e o f l o a d i n g y o u r o t h e r f i l e s f r o m 
c h i p . 
I f y o u 
use 
PROMOS 
c h i p 
f i l e s 
a 
l o t , 
y o u 
may 
want 
t o 
g e t 
t h e 


PROMOS/HESMON/WEDGE c a r t r i d g e , a v a i l a b l e f r o m CSM. I f y o u 
d o n ' t 
have PROMOS on c a r t r i d g e , y o u ' l l have t o make s u r e 
PROMOS 
i s n ' t 
l o c a t e d i n t h e same a r e a as t h e p r o g r a m y o u a r e 
d o w n l o a d i n g . 
I n 
any case, y o u may f i n d t h a t t h e p r o g r a m y o u download w i l l n o t r u n 
p r o p e r l y w i t h PROMOS e n a b l e d . 
Use 
RUN/STOP-RESTORE 
t o 
d i s a b l e 
PROMOS b e f o r e r u n n i n g t h e program. I f y o u 
a r e 
u s i n g 
a 
PROMOS 
c a r t r i d g e , y o u ' l l p r o b a b l y have t o s w i t c h i t o f f t o o , t o make t h e 
u n d e r l y i n g RAM a v a i l a b l e ( d i s a b l e PROMOS b e f o r e 
y o u 
s w i t c h 
o f f 
t h e c a r t r i d g e ) . 


T r a n s f e r r i n g p r o g r a m f i l e s f r o m 
a 
d i s k 
t o 
a 
c h i p 
i s f a i r l y 
s i m p l e , b u t d a t a f i l e s a r e much 
more 
t r o u b l e . 
Y o u ' l l 
have 
t o 
w r i t e a s p e c i a l p r o g r a m t o t r a n s f e r a 
d a t a 
f i l e f r o m 
d i s k 
t o 
c h i p . D a t a f i l e s must be w r i t t e n o n t o t h e c h i p one b y t e o r 
p i e c e 
o f d a t a a t a t i m e . I f y o u make a m i s t a k e w h i l e d o i n g t h i s , y o u ' l l 
have t o e r a s e t h e c h i p and s t a r t o v e r . 
I f y o u 
make 
a 
m i s t a k e 
o p e n i n g o r c l o s i n g a d a t a f i l e , i t i s p o s s i b l e . t o mess 
up 
t h e 
c h i p d i r e c t o r y . A l t h o u g h t h e p r e v i o u s 
f i l e s 
on 
t h e 
c h i p 
w i l l 
s t i l l be OK, y o u may n o t be a b l e t o add any more 
f i l e s . 
I f y o u 
want t o p u t s e v e r a l programs and 
d a t a 
f i l e s 
on 
a 
c h i p , 
y o u r 
chances o f making an e r r o r somewhere a l o n g t h e 
l i n e 
a r e 
p r e t t y 
good. To t o p i t o f f , PROMOS 1.1 
d o e s n ' t 
a l w a y s 
h a n d l e 
n u m e r i c 
d a t a c o r r e c t l y ( s e e b e l o w ) . 


I n s p i t e o f t h e l i m i t a t i o n s , y o u 
may 
want 
t o 
e x p e r i m e n t 
w i t h 
t h e s e commands t o see i f t h e y s u i t y o u r needs. The c o m p l e t e 
l i s t 
o f PROMOS f i l e commands i s g i v e n below. To h e l p y o u g e t 
s t a r t e d , 
w e ' l l go t h r o u g h a c o u p l e o f examples. T u r n 
o f f y o u r 
computer, 
i n s e r t t h e PROMENADE and t u r n t h e computer back on. Load and 
r u n 
PROMOS ( t h e f o l l o w i n g examples were t e s t e d w i t h PROMOS 1.1; 
o t h e r 
v e r s i o n s may w e l l g i v e d i f f e r e n t r e s u l t s ) . 
W e ' l l 
need 
a 
BASIC 
p r o g r a m t o u s e i n o u r examples, so t y p e i n t h e 
f o l l o w i n g 
s h o r t 
program: 


1 0 REM SAMPLE BASIC PROGRAM FOR 
20 REM PROMOS F I L E COMMANDS 
30 PRINT " H I THERE!" 


F i r s t w e ' l l save t h i s p r o g r a m t o an EPROM. 
E x e c u t e a Z command t o 
i n i t i a l i z e t h e PROMENADE ( t h i s may 
n o t 
be 
n e c e s s a r y 
b u t 
i t ' s 
a l w a y s a good i d e a ) . Now i n s e r t a 2764 
EPROM 
i n t h e 
PROMENADE 
( n o t c h t o t h e l e f t as a l w a y s ) and l o c k down t h e h a n d l e . 
To 
save 
t h e BASIC program, use: 


SAVE "SAMPLE:5", 
16, 7 


The " : 5 " 
i n t h e f i l e n a m e i s t h e C W 
( C o n t r o l 
Word) 
f o r 
a 
2764 
c h i p . The " 1 6 " i s t h e d e v i c e number f o r t h e 
PROMENADE, 
and 
t h e 
" 7 " i s a PMW ( P r o g r a m Method Word) s u i t a b l e f o r t h e 2764. 
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W h i l e t h e p r o g r a m i s b e i n g saved, t h e 
r e d 
SKT 
and 
y e l l o w 
PGM 
l i g h t s on t h e PROMENADE w i l l be lit. When i t i s f i n i s h e d , 
l i s t 
t h e d i r e c t o r y o f t h e c h i p w i t h t h e command: 


" $ " i s t h e d i r e c t o r y command, 
and " 5 " i s t h e CW. 
P r e s s any k e y t o 
s t e p t h r o u g h t h e d i r e c t o r y l i s t i n g . You s h o u l d see t h e f o l l o w i n g : 


0 
SAMPLE 
99 


The " 0 " t e l l s where i n t h e c h i p t h e p r o g r a m s t a r t s , and 
t h e 
" P " 
s t a n d s f o r a p r o g r a m f i l e . The "99" t e l l s where t h e n e x t f i l e y o u 
save w i l l s t a r t , and a l s o i n d i c a t e s 
t h e 
l e n g t h 
o f 
o u r 
SAMPLE 
program i n b y t e s 
( 9 9 - 0 = 99 b y t e s ) . 
T h i s 
l e n g t h 
i n c l u d e s 
a 
2 1 - b y t e d i r e c t o r y e n t r y . 
R a t h e r 
t h a n 
keep 
a l l 
t h e 
d i r e c t o r y 
e n t r i e s a t t h e b e g i n n i n 
o f t h e c h i p , PROMOS p u t s each e n t r y j u s t 
9 
b e f o r e t h e p r o g r a m i t s e f ( s o r t o f l i k e t a p e d i r e c t o r i e s ) . 


Next l e t ' s l o a d t h e f i l e back 
o f f 
t h e 
c h i 
F i r s t do 
a 
NEW 
command t o c l e a r o u t t h e o r i g i n a l program. 
R o w 
e n t e r 
t h e 
l o a d 
command: 


LOAD "SAMPLE: 5 " , 16 


Note t h e CW ( : 5 ) and d e v i c e number ( 1 6 ) . 


The r e d SKT l i g h t w i l l l i g h t up 
b r i e f l y 
w h i l e 
t h e 
p r o g r a m 
i s 
l o a d i n g . When i t ' s done, l i s t t h e p r o g r a m 
t o 
see 
t h a t i t was 
a c t u a l l y saved and l o a d e d c o r r e c t l y . You m i g h t a l s o t r y 
u s i n g 
a 
VERIFY command t o check t h a t t h e f i l e was saved c o r r e c t l y . Type: 


VERIFY "SAMPLE:5", 
16 


The SKT l i g h t w i l l come on a g a i n b r i e f l y . The message "VERIFYING" 
w i l l be p r i n t e d on t h e s c r e e n , and t h e n t h e message 
" O K " . 
Note: 
'OK' 
will be printed whether or not there is a verify error. If 
t h e r e was an e r r o r , t h e y e l l o w PGM l i g h t w i l l b e g i n f l a s h i n g . Use 
t h e Z command t o c l e a r t h e e r r o r . 


L e t ' s t r y t o cause a v e r i f y e r r o r . 
L i s t 
t h e 
program. 
Use 
t h e 
c u r s o r t o go 
up 
t o 
l i n e 
30 
and 
change 
t h e 
" H I THERE!" 
t o 
"HO HO H O ! " . 
Now e n t e r t h e v e r i f y command a g a i n . S u r p r i s e d ? There 
was no e r r o r r e p o r t e d a t a1 1 - no f l a s h i n g PGM l i g h t . The VERIFY 
command is not reliable! We recommend t h a t y o u d o n ' t u s e i t . We 
have d e l e t e d w h o l e l i n e s f r o m a p r o g r a m and n o t g o t t e n 
a 
v e r i f y 
e r r o r . T h i s p r o b l e m was e n c o u n t e r e d w i t h PROMOS v e r s i o n 1.1 
( t h e 
most r e c e n t u p d a t e as t h i s i s w r i t t e n ) . The p r o b l e m may be 
f i x e d 
i n f u t u r e u p d a t e s . 
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Now l e t ' s t r y t h e s p e c i a l " n o n r e l o c a t a b l e " f i l e commands: 
s h i f t - L 
(LOAD) and s h i f t - S (SAVE). These can be u s e d t o l o a d o r save f r o m 
any a r e a o f memory, n o t j u s t t h e BASIC p r o g r a m a r e a 
( s h i f t - L 
i s 
l i k e LOAD"name",8,1). 
As a t e s t program, l e t ' s u s e M I C R O M O N 49152 
f r o m t h e program d i s k w i t h t h i s book. 
T h i s 
p r o g r a m 
r e s i d e s 
a t 
49152-53247 ($C000-CFFF) i n memory. P u t t h e p r o g r a m d i s k 
i n t h e 
d r i v e and l o a d t h e p r o g r a m i n t o memory: 


LOAD " M I C R O M O N 49152", 
8, 
1 


Type NEW t o r e s e t t h e BASIC p o i n t e r s and a v o i d p o t e n t i a l "Out 
o f 
Memory" e r r o r s . To save t h i s p r o g r a m t o t h e c h i p , e n t e r : 


The s h i f t - S w i l l l o o k l i k e a h e a r t i n t h e 
normal 
c h a r a c t e r 
s e t 


( u p p e r c a s e / g r a p h i c s ) . 
D O NOT p u t q u o t e s a r o u n d t h e f i l e name, 
and 
D O NOT p u t any spaces between t h e s h i f t - S and 
t h e 
name 
( u n l e s s 
y o u want t h e q u o t e s o r spaces t o become p a r t o f 
t h e 
name). 
The 


":5" 
i s t h e CW, 
t h e n e x t t w o numbers a r e t h e b e g i n n i n g and e n d i n g 
addresses o f t h e a r e a i n t h e computer t o save, and t h e " 7 " i s t h e 
PMW. 
The e n d i n g a d d r e s s y o u u s e ( 5 3 2 4 8 ) must be 1 b y t e 
p a s t 
t h e 
a c t u a l e n d i n g a d d r e s s . N o t e t h a t y o u d o n ' t have t o s p e c i f y d e v i c e 
16 ( t h e 
PROMENADE), 
s i n c e i t i s assumed 
a u t o m a t i c a l l y 
w i t h 
s h i f t - S and s h i f t - L . 


When t h e p r o g r a m has been saved, l i s t t h e 
d i r e c t o r y 
a g a i n 
( u s e 
$ 5 ) . You s h o u l d see: 


0 
SAMPLE 
P 
99 
M I C R O M O N 
P 
421 6 


The M I C R O M O N p r o g r a m now r e s i d e s on t h e c h i p f r o m b y t e 99 t o b y t e 
4215 (4096 b y t e s p l u s t h e 2 1 - b y t e d i r e c t o r y e n t r y ) . To 
l o a d 
t h e 
f i l e back o f f t h e c h i p , use: 


The s h i f t - L w i l l l o o k l i k e a f a t " L " . 
DO NOT 
p u t 
q u o t e s 
a r o u n d 
t h e name o r spaces a f t e r t h e s h i f t - L . I f y o u t y p e t h e wrong name, 
t h e y e l l o w l i g h t w i l l f l a s h . A f t e r t h e 
p r o g r a m 
i s l o a d e d , 
y o u 
m i g h t want t o e x e c u t e i t i n o r d e r t o v e r i f y i t . Use SYS 49152. 


T h i s b r i n g s u s t o d a t a f i l e s . 
We 
m e n t i o n e d 
above 
t h a t 
PROMOS 
d o e s n ' t h a n d l e n u m e r i c d a t a c o r r e c t l y i n d a t a 
f i l e s 
( a t 
l e a s t 
v e r s i o n 1.1 d o e s n ' t ) . When y o u u s e PRINT# t o save n u m e r i c d a t a t o 
a f i l e on a c h i p , y o u m u s t u s e a s e p a r a t e 
PRINT# 
s t a t e m e n t 
f o r 
each number. T h i s i s n o t r e q u i r e d when y o u w r i t e n u m e r i c d a t a 
t o 
a d i s k f i l e . A l s o , y o u w i l l n o t b e a b l e t o r e a d t h e 
number 
back 
c o r r e c t l y f r o m a c h i p d a t a f i l e u n l e s s 
y o u 
PRINT# 
a 
comma 
o r 


CHR$(13) (RETURN) c h a r a c t e r t o t h e f i l e a f t e r 
t h e 
number. 
T h i s 
must be done i n t h e f o l l o w i n g PRINT# s t a t e m e n t , s i n c e t h e 
number 
must be i n a PRINT# s t a t e m e n t 
b y 
i t s e l f . 
Even 
t h i s 
t e c h n i q u e 
d o e s n ' t work a l l t h e t i m e ( t h e s e 
p r o b l e m s 
may 
be 
f i x e d 
i n a 
f u t u r e u p d a t e o f PROMOS). PROMOS 
seems 
t o 
h a n d l e 
s t r i n g 
d a t a 
c o r r e c t l y , b u t we c a n ' t g u a r a n t e e it. 
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The f u l l s e t o f PROMOS f i l e commands i s documented below. 


F I L E COMMANDS 


NOTE: A l l f i l e commands e x c e p t $, 
s h i f t - L and s h i f t - S c a n be used 
w i t h i n BASIC 
programs. 
I n BASIC 
programs 
o r 
i m m e d i a t e 
mode 
commands, v a r i a b l e s may be used i n p l a c e o f numbers o r f i l e n a m e s . 
PROMOS commands may a l s o be used f r o m 
w i t h i n 
many 
ML 
m o n i t o r s 
( s e e t h e c h a p t e r on ML m o n i t o r s and PROMOS). 


$cw - L i s t s t h e c h i p d i r e c t o r y t o t h e s c r e e n . Each t i m e y o u p r e s s 
a key a n o t h e r f i l e e n t r y i s d i s p l a y e d . Use t h e c u r s o r down k e y t o 
s t e p t h r o u g h t h e d i r e c t o r y c o n t i n u o u s l y . Each f i l e e n t r y c o n s i s t s 
of: 
t h e f i l e l o c a t i o n w i t h i n t h e c h i p ( s t a r t i n g f r o m b y t e 0 ) ; t h e 
f i l e name; t h e f i l e t y p e ( P r o g r a m o r D a t a ) ; and t h e 
f i l e 
s t a t u s 
( * = n o t c l o s e d ) . The number o f b y t e s 
used 
so 
f a r 
on 
t h e 
c h i p 
appears a t t h e end o f t h e l i s t . The "cw" 
i s a 
s p e c i a l 
c o n t r o l 
word t h a t v a r i e s d e p e n d i n g on t h e 
t y p e 
o f 
c h i p 
used. 
C o n t r o l 
words a r e d i s c u s s e d i n t h e c h a p t e r on b u r n i n g EPROMs. 


SAVE 'name:cwm, 
16, pmw - Saves a p r o g r a m o n t o t h e c h i p f r o m 
t h e 
BASIC a r e a , and i n s e r t s a f i l e e n t r y f o r 
t h e 
p r o g r a m 
i n t o 
t h e 
c h i p d i r e c t o r y . The "pmw" i s a s p e c i a l p r o g r a m method 
w o r d 
t h a t 
v a r i e s d e p e n d i n g on t h e t y p e of c h i p ( s e e t h e c h a p t e r on 
b u r n i n g 
EPROMs ) . 


LOAD 'name:cwm, 
1 6 - Loads t h e s p e c i f i e d p r o g r a m 
f i l e 
i n t o 
t h e 
BASIC area, r e a g r d l e s s 
o f t h e l o a d a d d r e s s i n t h e f i l e . The f i l e 
must be r e l o c a t a b l e , i . e . i t must have 
been 
c r e a t e d 
u s i n g 
t h e 
SAVE command above. 


(Shift-S)name:cw, 
C 6 4 - s t a r t , 
C64-end, 
psw - Saves a p r o g r a m 
f i l e 
t o t h e c h i p f r o m 
any 
a r e a 
i n C64 
memory, 
s p e c i f i e d 
b y 
t h e 
C 6 4 - s t a r t and end addresses. The e n d i n g a d d r e s s y o u 
s u p p l y 
must 
be 1 g r e a t e r t h a n t h e a c t u a l end o f t h e program. The s h i f t - S must 
be t h e f i r s t c h a r a c t e r on t h e l i n e ( i t l o o k s l i k e a 
h e a r t ) . 
No 
q u o t e s a r e a l l o w e d a r o u n d t h e f i l e name, 
and t h e name must 
b e g i n 
i m m e d i a t e l y a f t e r t h e s h i f t - S . The f i l e c r e a t e d b y 
t h i s 
command 
i s n o n - r e l o c a t a b l e , 
i.e., 
i t must be l o a d e d back 
i n t o 
t h e 
same 
a r e a o f C64 memory t h a t i t was saved o u t f r o m ( u s i n g t h e 
s h i f t - L 
command be1 ow). 


(Shift-L)name:cw - Loads a f i l e p r o d u c e d b y s h i f t - S back i n t o t h e 
a r e a o f memory i t was saved f r o m . The s h i f t - L must be 
t h e 
f i r s t 
c h a r a c t e r on t h e l i n e ( i t l o o k s l i k e a t h i c k L ) . 
No 
q u o t e s 
a r e 
a l l o w e d around t h e f i l e name, 
and t h e name must b e g i n i m m e d i a t e l y 
a f t e r t h e s h i f t - L . 
Ycan a l s o 
u s e 
t h i s 
command 
t o 
l o a d 
f i l e s 
c r e a t e d by t h e r e g u l a r SAVE command. 


VERIFY 'name:cwm, 
1 6 - V e r i f i e s t h a t a p r o g r a m s t o r e d on t h e c h i p 
w i t h t h e SAVE command matches t h e p r o g r a m i n t h e BASIC area. T h i s 
command i s n o t r e l i a b l e ! 


EPROM HANDBOOK 
PROMOS 
PAGE 28 


OPEN filenum, 16, pmw, 'nase:cwm - Opens a data f i l e on t h e chip. 
I t cannot be used t o open a program f i l e . I f t h e f i l e does 
not 
already e x i s t when you t r y t o 
O P E N 
i t , 
PROMOS 
w i l l 
c r e a t e a 
d i r e c t o r y e n t r y f o r i t . Newly c r e a t e d f i l e s MUST be closed before 
any o t h e r f i l e s a r e c r e a t e d o r you may 
c o r r u p t 
t h e d i r e c t o r y ! . 
PROMOS w i l l l e t you w r i t e t o O R read from a f i l e once i t i s open. 
N O T E : I f you reopen a f i l e t h a t 
has 
already 
been 
c r e a t e d 
and 
closed once, w r i t i n g t o t h e f i l e can 
c o r r u p t 
t h e d a t a 
already 
stored! To prevent t h i s , add 32 t o t h e usual PMW when 
you 
f i r s t 
O P E N t h e f i l e t o c r e a t e i t . Once i t has 
been 
closed, 
t h e f i l e 
w i l l be protected from f u r t h e r w r i t i n g . 


PRINTifilenua, data - Writes 
d a t a 
d i r e c t l y 
i n t o 
t h e 
f i l e 
s p e c i f i e d by filenum. You should only w r i t e t o f i l e s which 
have 
j u s t been c r e a t e d by O P E N ! Data can c o n s i s t 
of 
quoted 
s t r i n g s , 
s t r i n g v a r i a b l e s , numbers, numeric v a r i a b l e s o r CHR$() codes 
( i n 
theory, a t l e a s t - PROMOS 1.1 does not handle numbers c o r r e c t l y ) . 


CMD filenum - D i r e c t s a l l 
output 
from 
r e g u l a r 
PRINT 
o r 
LIST 
statements t o t h e s p e c i f i e d 
f i l e . 
More 
convenient 
than 
using 
PRINT# b u t may be undependable. Once again, use with newly OPENed 
f i l e s only! 


IMPUTifilenum, variable(s1 - Inputs d a t a from an open f i l e on t h e 
chip and places i t i n t h e s p e c i f i e d v a r i a b l e ( s ) . Each 
piece 
of 
d a t a on t h e chip must end with a R E T U R N c h a r a c t e r , colon 
: 
o r 
comma. I f you t r y t o read p a s t t h e end of f i l e , t h e yellow 
e r r o r 
l i g h t on t h e P R O M E N A D E w i l l f l a s h , b u t no e r r o r w i l l 
be 
returnd 
t o t h e program you a r e using. 


GETifilenum, variable(s1 - Gets 
d a t a from 
t h e f i l e i n t o t h e 
s p e c i f i e d 
v a r i a b l e ( s ) . Only 
one 
byte w i l l 
be 
p u t 
i n 
each 
v a r i a b l e . Less convenient b u t more useful than INPUT#. 


CLOSE filenum - Closes a f i l e a f t e r a l l access 
i s f i n i s h e d . 
Be 
s u r e t o C L O S E every f i l e a f t e r i t i s c r e a t e d ! 


Once again, t h e s e commands may seem very u s e f u l , b u t we've 
found 
t h a t working w i t h them can be q u i t e a h a s s l e . We 
recommend 
t h a t 
you use a c a r t r i d g e f o r s t o r i n g programs. 
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ML MONITORS AND PROMOS 


A l t h o u g h i t i s n o t a b s o l u t e l y necessary, a good 
ML 
m o n i t o r 
can 
come i n v e r y handy when 
programming 
EPROMs. 
B e f o r e 
b u r n i n g 
a 
program o n t o EPROM, y o u ' l l u s u a l l y have t o make a t 
l e a s t 
a 
few 
m o d i f i c a t i o n s , u n l e s s you a r e j u s t c o p y i n g a n o t h e r ROM. 
The EPROM 
p r o j e c t s i n t h i s book w i 11 r e q u i r e t h e use o f a good ML 
m o n i t o r . 
You may a l r e a d y have a f a v o r i t e m o n i t o r t h a t y o u w i s h t o use, 
o r 
y o u may want t o g e t t h e HESMON/PROMOS/WEDGE 
c a r t r i d g e 
a v a i l a b l e 
f r o m CSM. 
When c h o o s i n g a m o n i t o r t o use w i t h 
PROMOS, 
l o o k 
f o r 
one t h a t l e t s y o u e x e c u t e PROMOS 
commands 
w i t h o u t 
e x i t i n g 
t h e 
m o n i t o r . T h i s i s n o t an a b s o l u t e n e c e s s i t y , j u s t 
a 
convenience. 
Most 
m o n i t o r s 
a r e 
c o m p a t i b l e 
w i t h 
PROMOS 
i n t h i s 
r e s p e c t , 
i n c l u d i n g HESMON. 


To use PROMOS and HESMON t o g e t h e r , y o u 
s h o u l d 
always 
s t a r t 
up 
HESMON f i r s t , t h e n e x i t t o BASIC w i t h t h e 
" X C " 
command. 
Enable 
t h e c a r t r i d g e v e r s i o n o f PROMOS w i t h SYS 9*4096 ( o r 
SYS 
36864). 
I f y o u j u s t have t h e r e g u l a r HESMON c a r t r i d g e , l o a d and 
r u n 
t h e 
d i s k v e r s i o n o f PROMOS as u s u a l . HESMON moves t h e 
end 
of 
BASIC 
down t o $8000 ( t h r o u g h t h e p o i n t e r a t $37-38), so when PROMOS 
i s 
r u n f r o m d i s k i t w i l l l o c a t e i t s e l f b e f o r e $8000 ( a t $76DO). Once 
PROMOS i s enabled, y o u can r e e n t e r HESMON. DON'T use t h e 
RESTORE 
key, however, s i n c e t h i s w i l l " c o l d - s t a r t " 
HESMON 
and 
w i p e 
o u t 


PROMOS's p a t c h e s i n t o t h e KERNAL. The b e s t way t o r e e n t e r 
HESMON 
i s t o e x e c u t e a machine language BRK i n s t r u c t i o n . How do 
y o u 
do 
t h i s from BASIC? S i m p l e - j u s t SYS t o a l o c a t i o n t h a t c o n t a i n s 
a 
$00 b y t e (BRK i n s t r u c t i o n ) . We recommend u s i n g SYS 8 f o r t h i s 
on 
t h e C64 ( i t may n o t work on t h e C128 - t r y SYS 7168). When y o u do 
t h i s y o u ' l l r e e n t e r HESMON w i t h PROMOS s t i l l a c t i v e . 


A l l PROMOS and HESMON 
commands 
s h o u l d 
f u n c t i o n 
n o r m a l l y . 
One 
t h i n g t o be aware o f , as p o i n t e d o u t i n t h e PROMENADE manual, 
i s 
t h a t y o u ' l l g e t a " ? " f r o m HESMON 
a n y t i m e 
y o u 
e n t e r 
a 
PROMOS 
command. I n s p i t e 
o f 
t h i s , 
t h e 
PROMOS 
command 
w i l l 
e x e c u t e 
c o r r e c t l y . A n o t h e r t h i n g t o remember i s t h a t 
PROMOS 
w i l l 
s t i l l 
r e q u i r e a l l I t s commands i n DECIMAL, w h i l e HESMON 
commands 
w i l l 
r e q u i r e 
HEX. 
F o r t u n a t e l y , 
HESMON 
has 
d e c i m a l / h e x 
c o n v e r s i o n 
f u n c t i o n s ! One more p o i t - i f y o u e x i t HESMON 
w i t h 
t h e 
" X " 
o r 
" X C " commands, 
HESMON w i l l r e s t o r e 
t h e 
KERNAL 
v e c t o r s 
and 
so 
d i s a b l e PROMOS. 
A b e t t e r way t o e x i t HESMON i s w i t h G A474. 
T h i s 
pops y o u d i r e c t l y t o t h e 
BASIC 
r e a d y 
message, 
l e a v i n g 
PROMOS 
s t i l l hooked i n . Remember - 
use 
SYS 8 
t o 
r e e n t e r 
HESMON 
and 
G A474 t o e x i t i t . 


I n case you d o n ' t a l r e a d y have a good m o n i t o r , we've i n c l u d e d t h e 
u b l i c domain program M I C R O M O N on 
t h e 
program 
d i s k 
w i t h 
t h i s 


l o o k . 
F i v e 
v e r s i o n s 
o f 
M I C R O M O N 
a r e 
i n c l u d e d , 
f o r 
maximum 
f l e x i b i l i t y . They a r e i d e n t i c a l e x c e p t t h a t 
each 
l o a d s 
i n t o 
a 
d i f f e r e n t a r e a o f memory. S i n c e M I C R O M O N i s p u b l i c 
domain, 
you 
a r e f r e e t o copy and d i s t r i b u t e i t as 
y o u 
w i s h . 
M I C R O M O N 
was 
o r i g i n a l l y w r i t t e n b y B i l l S e i l e r i n t h e days o f 
t h e 
e a r l y 
P E T 
computers, and t h e r e a r e many d i f f e r e n t v e r s i o n s o f i t f l o a t i n g 
around t o d a y . T h i s p a r t i c u l a r v e r s i o n i s t h e b e s t we've seen. 
It 
was p r o v i d e d t o us b y Steven C. 
S c h n e d l e r o f 
S c h n e d l e r 
Systems, 
1501 N. 
Ivanhoe Dept R8, A r l i n g t o n , V A 22305 (703-237-4796). 
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M I C R O M O N i s c o m p a t i b l e w i t h PROMOS, 
i.e., 
PROMOS commands c a n 
be 
e x e c u t e d f r o m w i t h i n M I C R O M O N . To s e t t h i s 
up, 
y o u 
s h o u l d 
r u n 
PROMOS before y o u e n t e r M I C R O M O N . 
From t h e n on y o u can e n t e r 
and 
e x i t MICROMON n o r m a l l y w i t h o u t d i s t u r b i n g PROMOS ( u s e " E N o r 
" X u 


t o e x i t ) . 
Most 
of 
t h e 
commands 
f o r 
M I C R O M O N 
a r e 
t h e 
same 
" s t a n d a r d " 
commands 
used 
b y 
many 
o t h e r 
m o n i t o r s 
such 
as 


HESMON(tm) and HIMON ( f r o m P P M V o l . I & 1 1 ) . I n a d d i t i o n , 
t h e r e 
a r e s e v e r a l commands 
i n t h i s 
v e r s i o n 
o f 
M I C R O M O N 
w h i c h 
a r e 
p a r t i c u l a r l y u s e f u l when programming EPROMs. 


A d e s c r i p t i o n of t h e M I C R O M O N commands i s g i v e n below. I f y o u a r e 
a l r e a d y f a m i l i a r w i t h an ML m o n i t o r , y o u m i g h t want t o s k i m 
o v e r 
t h i s m a t e r i a l and n o t e any e x t r a commands and 
f e a t u r e s . 
I f y o u 
a r e n ' t f a m i l i a r w i t h an ML 
m o n i t o r 
y e t , 
y o u 
s h o u l d 
r e a d 
t h e 
d e s c r i p t i o n s t o g e t an i d e a o f what a m o n i t o r c a n do. 
D o n ' t 
t r y 
t o memorize e v e r y command; y o u c a n r e f e r back t o t h i s c h a p t e r 
as 
needed t h r o u g h o u t t h e r e s t o f t h e book. 


MICROMON COMMANDS 


NOTES: 


1 ) A l l c a p i t a l 
l e t t e r s 
must 
be 
t y p e d 
as 
shown. 
Lowercase 
l e t t e r s s t a n d f o r i n f o r m a t i o n t o be s u p p l i e d 
b y 
t h e 
u s e r 


( h h = any hex v a l u e ) . 


2 ) A l l numbers must be e n t e r e d i n hex ( w i t h no $ ) e x c e p t i n t h e 
number c o n v e r s i o n f u n c t i o n s . 


3 ) B r a c k e t s ( [ I ) a r o u n d an i t e m 
mean 
t h a t i t i s o p t i o n a l 
( d o n ' t t y p e t h e b r a c k e t s ) . 


Starting up MICROMON 


F i v e c o p i e s o f M I C R O M O N a r e i n c l u d e d on t h e d i s k . Each l o a d s i n t o 
a d i f f e r e n t a r e a o f memory. The name o f t h e f i l e i n d i c a t e s 
where 
i n memory t h e v e r s i o n r e s i d e s . It a l s o t e l l s y o u t h e SYS 
a d d r e s s 
t o u s e t o s t a r t t h e m o n i t o r . F o r 
example, 
t o 
use 
t h e 
v e r s i o n 
l o c a t e d a t 49152 ($C000), f i r s t l o a d i t w i t h : 


LOAD " M I C R O M O N 49152", 8, 1 


To e x e c u t e t h e m o n i t o r , u s e t h e command: 


SYS 49152 


T h i s SYS command w i l l cause a c o m p l e t e c o l d - s t a r t o f M I C R O M O N . I f 
y o u ' v e a l r e a d y e n t e r e d and e x i t e d t h e m o n i t o r once ( w i t h 
a 
s o f t 
e x i t ) , y o u c a n r e e n t e r i t w i t h a s l i g h t l y s i m p l e r command t h a t i s 
t h e same f o r a l l t h e v e r s i o n s . 
L i k e 
HESMON, 
M I C R O M O N 
w i l l 
be 
a c t i v a t e d any t i m e a BRK i n s t r u c t i o n i s e x e c u t e d . You c a n f o r c e a 
BRK b y u s i n g SYS 8 on t h e C64. 
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E x i t Commands 


X 
- 
(SOFT EXIT) 
E x i t s M I C R O M O N t o BASIC, l e a v i n g t h e 
BRK 
and 
I R Q v e c t o r s as s e t b y M I C R O M O N . T h i s a l l o w s 
y o u 
t o 
' h o t - s t a r t ' 
M I C R O M O N by e x e c u t i n g a BRK i n s t r u c t i o n f r o m BASIC, 
u s i n g 
SYS 8 
f o r i n s t a n c e . The " X " 
command w i l l l e a v e PROMOS e n a b l e d . 


E - 
(HARD EXIT) 
E x i t s 
M I C R O M O N 
t o 
BASIC 
b u t 
r e s t o r e s 
t h e 
p r e v i o u s c o n t e n t s o f t h e BRK and I R Q 
v e c t o r s 
( s e t 
by 
PROMOS). 
M I C R O M O N must be c o l d - s t a r t e d t o r e e n t e r it. T h i s 
command 
w i l l 
l e a v e PROMOS e n a b l e d . 


K - 
( K I L L ) 
Exits'MICROMON t o BASIC and r e s t o r e s 
t h e 
power-up 
v a l u e s 
o f 
t h e 
BRK 
and 
I R Q 
v e c t o r s . 
Same 
e f f e c t 
as 


RUN/STOP-RESTORE. 
T h i s command w i l l d i s a b l e PROMOS. 


6 FCEZ - 
(RESET) 
T o t a l l y r e s e t s t h e computer. 


F i 1 e commands 


L [ a l t . addr] " f i l e " [ , d e v l 
- 
(LOAD) 
Loads a 
f i l e f r o m 
d i s k 
( n o t a p e ) . I f [ , d e v l 
i s o m i t t e d , d e v i c e 8 w i l l 
be 
s e l e c t e d . If 


[ a l t . addr.] 
i s s p e c i f i e d , 
t h e 
f i l e w i l l 
be 
l o a d e d 
a t 
t h a t 
a d d r e s s r a t h e r t h a n i t s normal l o a d a d d r e s s . T h i s i s v e r y 
u s e f u l 
f o r EPROM work. A f t e r l o a d i n g , t h e e n d i n g a d d r e s s o f t h e 
p r o g r a m 


( + I ) w i l l be p r i n t e d . 


s h i f t - L [ a l t . a d d r l " f i l e " [,dev] 
- 
(Dummy LOAD) 
Same 
as 
L, 
b u t does n o t a c t u a l l y l o a d t h e f i l e . 
Used 
t o 
f i n d 
t h e 
e n d i n g 
address o f a p r o g r a m ( + I ) . 


V " f i l e ' [,dev] 
- 
(VIEW) 
P r i n t s t h e l o a d a d d r e s s of t h e 
f i l e , 
b u t does n o t l o a d it. 


S ' f i l e " , 
s t a r t , end+l [,dev] 
- 
(SAVE) 
Saves an a r e a o f memory 
t o d i s k . N o t e t h a t t h e end a d d r e s s y o u g i v e 
m u s t 
be 
1 
g r e a t e r 
t h a n t h e a c t u a l end. 


Memory Commands 


A addr i n s t r u c t i o n - 
(ASSEMBLE) 
Assembles one 
ML 
i n s t r u c t i o n 
i n t o memory s t a r t i n g a t t h e s p e c i f i e d a d d r e s s . A l l 
a d d r e s s e s 
i n 
t h e INSTRUCTION must b e 
p r e c e d e d 
b y 
a 
$. 
A l s o 
a u t o m a t i c a l l y 
i n s e r t s an " A " on t h e f o l l o w i n g l i n e t o 
p r e p a r e 
f o r 
a s s e m b l i n g 
a n o t h e r s t a t e m e n t . H i t r e t u r n o r move t o 
a 
b l a n k 
l i n e 
t o 
end 
assembly. 
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D start [,end] 
- 
(DISASSEMBLE) 
D i s a s s e m b l e s 
memory 
i n t o 
hex 
and mnemonics. I f o n l y t h e s t a r t a d d r e s s i s g i v e n , o n l y one 
l i n e 
of code w i l l be d i s p l a y e d . I f end i s a l s o s p e c i f i e d , 
t h e 
e n t i r e 
r a n g e w i l l be d i s a s s e m b l e d . I n e i t h e r case, t h e 
d i s a s s e m b l y 
can 
be c o n t i n u e d backward o r f o r w a r d i n memory by g o i n g t o t h e t o p o r 
b o t t o m ( r e s p e c t i v e l y ) o f t h e s c r e e n . Then 
u s e 
t h e 
up 
o r 
down 
c u r s o r k e y t o s c r o l l t h e s c r e e n . I l l e g a l opcodes w i l l d i s a s s e m b l e 
as ? ? ? . The D command a u t o m a t i c a l l y p u t s a comma command , 
as 
t h e f i r s t c h a r a c t e r o n t h e l i n e s d i s p l a y e d . See t h e comma command 
( n e x t ) . 
, addr hex-code(s) - 
(MODIFY DISASSEMBLY) 
A l l o w s 
a 
d i s a s s e m b l e d l i n e t o be m o d i f i e d . Changes must 
be 
made 
i n hex 
o n l y ( u s e t h e " A " command t o assemble 
mnemonics). 
A u t o m a t i c a l l y 
r e d i s p l ays 1 i 
ne i 
n c l u d i ng new mnemonics. 


M start [,end] 
- 
(MEMORY DISPLAY) 
D i s p l a y s memory i n hex 
and 
ASCII. Each l i n e c o n s i s t s o f 8 hex b y t e s f o l l o w e d by t h e i r 
ASCII 
e q u i v a l e n t s ( i n r e v e r s e ) . D i s p l a y c a n be 
c o n t i n u e d 
backward 
o r 
f o r w a r d b y s c r o l l i n g s c r e e n 
as 
i n t h e 
" D " 
command. 
A 
c o l o n 
command ( : ) i s a u t o m a t i c a l l y i n s e r t e d as t h e f i r s t 
c h a r a c t e r 
of 
t h e l i n e d i s p l a y e d . See t h e c o l o n command ( n e x t ) . 
: addr hh h h . . hh - 
(MEMORY MODIFY) 
S t o r e 8 
b y t e s 
i n memory 
s t a r t i n g a t a d d r e s s g i v e n . 


R - 
(REGISTER DISPLAY) 
D i s p l a y s t h e c o n t e n t s o f t h e A , X y Y 
and 
s t a t u s r e g i s t e r s when M I C R O M O N was 
e n t e r e d . 
A l s o 
d i s p l a y s 
t h e 
s t a c k p o i n t e r , p r o g r a m c o u n t e r and I R Q v e c t o r . 
A 
s e m i c o l o n 
( ; I 


command i s a u t o m a t i c a l l y i n s e r t e d i n t h e 
r e g i s t e r 
d i s p l a y . 
See 
t h e s e m i c o l o n command ( n e x t ) . 
; pc irq status a x y stack - 
(REGISTER MODIFY) 
A l l o w s y o u 
t o 
e d i t t h e v a l u e s saved f o r t h e r e g i s t e r s , e t c . 
These 
v a l u e s 
a r e 
r e s t o r e d b e f o r e a "G", 
" W " o r "Q" command. 


F start end h h - 
( F I L L ) 
F i l l s an a r e a o f memory w i t h 
t h e 
hex 
v a l u e hh. 


C start1 end1 start2 - 
(COMPARE) 
Compares t w o a r e a s o f memory. 
Any t i m e c o r r e s p o n d i n g l o c a t i o n s i n t h e t w o a r e a s do 
n o t 
match, 
t h e a r e a l a d d r e s s i s p r i n t e d . I f a r e a l i s l o w e r 
i n memory 
t h a n 


range2, t h e c o m p a r i s o n w i l l p r o c e e d 
backwards 
s t a r t i n g 
a t 
t h e 
ends o f t h e ranges. To a v o i d t h i s , u s e t h e l o w e r o f t h e t w o a r e a s 
f o r area2. 


T source-start source-end dest-start - 
(TRANSFER) 
C o p i e s 
t h e 
s o u r c e a r e a t o t h e d e s t i n a t i o n 
area. 
The 
s o u r c e 
a r e a 
i s n o t 
a l t e r e d ( u n l e s s t h e a r e a s o v e r l a p ) . B y t e s a r e v e r i f e d as t h e y a r e 
t r a n s f e r r e d and any mismatches a r e r e p o r t e d on t h e s c r e e n . 


H start end hh h h . .. o r 
H start end 'string.. - 
(HUNT) 
H u n t s 
t h r o u g h an a r e a o f memory f o r t h e hex o r ASCII 
v a l u e s 
g i v e n . 
A 
maximum o f 32 b y t e s may be s e a r c h e d f o r . Do n o t u s e a n o t h e r ' 
a t 
t h e end o f an ASCII s t r i n g . 
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Output Commands 


P - 
(PRINT) 
Switches a l l o u t p u t from the screen t o the printer 
(device 4 ) or vice versa. You must h i t return TWICE a f t e r the 
P 
before entering next command. Use P again 
t o return 
o u t p u t 
t o 


screen.If the l a s t l i n e of printing i s 
'stuck' 
in 
the 
printer 
buffer (delayed printing), switching o u t p u t t o printer 
and 
back 
again should cause i t t o print. 


OPEN filenum, dev [,s.a.l 
[,'stringnl 
:CMD filenum - 
(General 
o u t p u t ) 
If the "P" command f a i l s t o work 
correctly with 
your 
printer, e x i t t o BASIC a n d 
enter 
t h i s 
line. 
Use 
the 
correct 
device number a n d s.a. (secondary address, i f 
needed) 
for your 
printer. If a string i s specified, i t will be used 
as 
a 
t i t l e . 
Reenter M I C R O M O N and perform the desired functions. 
When 
you're 
finished 
w i t h 
the 
printer, 
e x i t 
t o 
BASIC 
a n d 
enter 


PRINTifilenum :CLOSE filenum. This technique can also be used 
t o 
store o u t p u t in a disk f i l e , by giving 
the 
appropriate 
device, 
etc. The string will be used as a f i l e name. Be sure t o open 
the 
f i l e for writing by putting ",W" in f i l e name a f t e r the f i l e type 
( P , S or U ) . 


Debugging Commands 


6 [addrl - 
( G O ) 
Restores the values 
of 
the 
registers, 
etc. 
t h a t were saved when M I C R O M O N was entered 
(see 
R 
command) 
and 
then executes an ML routine. If [addr] i s given, execution begins 
a t t h a t location. Otherwise, execution 
begins 
a t the 
location 
given by the saved program counter. The ML routine must end 
with 
a B R K instruction in order t o return t o M I C R O M O N . 


W [addrl - 
( W A L K ) 
Restores the saved values of the 
registers, 
etc. and begins executing ML code 
one 
instruction 
a t 
a 
time. 
Prior 
t o executing 
an 
instruction 
(except the f i r s t ) , the 
following 
values 
are displayed: 
the 
s t a t u s , 
A , 
X, 
a n d 
Y 
registers; the stack pointer; the 
program 
counter 
(address of 
next instruction); a n d f i n a l l y , the hex and mnemonic f o r the next 
instruction. If [addr] i s specified, 
execution 
begins 
a t 
t h a t 
location. Otherwise the saved value of 
the 
program 
counter 
i s 
used. Pressing any key (except J and S T O P ) will execute the 
next 
instruction. Pressing the 
" J " key 
will 
execute 
a 
subroutine 
uninterrupted, until an RTS instruction i s encountered. Executing 
a B R K instruction or hitting the STOP key will return 
t o normal 
MICROMON command mode and save the current register, etc. values. 


Q [addrl - 
(QUICK T R A C E ) 
Exactly like the "W" command 
except: 
execution 
i s continuous; 
the 
instructions executed 
are 
n o t 
displayed; use STOP and " = " 
keys 
simultaneously 
t o return 
t o 
M I C R O M O N ; the 
"B" 
command 
can 
be 
used 
t o s e t 
an 
optional 
"breakpoint". 


B addr [hhhhl - 
( B R E A K P O I N T SET) 
Sets u p 
a 
"breakpoint" for 
the "Q" command. When execution reaches the address given, a 
BRK 
instruction i s executed t o return 
t o MICROMON. 
If 
[ h h h h ] 
i s 
specified, the B R K i s executed only a f t e r the given 
address 
has 
been executed t h a t number of times. 
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Math Commands 


N code-start code-end o f f s e t r e f - b e g i n r e f - e n d [WI 
- 


(NEW LOCATION) 
Used t o r e l o c a t e a s e c t i o n o f ML code - 
s o r t 
o f 
l i k e a RENUMBER command i n BASIC. A f t e r moving t h e code w i t h 
t h e 


"T" command, t h i s command w i l l a d j u s t a b s o l u t e memory 
r e f e r e n c e s 
( n o t b r a n c h l o c a t i o n s ) t o r e f l e c t t h e c o d e ' s 
new 
l o c a t i o n . 
The 
a r e a s p e c i f i e d b y c o d e - s t a r t and code-end w i l l 
be 
s e a r c h e d 
f o r 
any ( t h r e e - b y t e ) i n s t r u c t i o n s w h i c h r e f e r e n c e t h e a r e a 
s p e c i f i e d 
by r e f - s t a r t and r e f - e n d . Any r e f e r e n c e s f o u n d w i l l 
be 
a d j u s t e d 
b y a d d i n g t h e o f f s e t 
v a l u e . 
To 
c a l c u l a t e 
t h e 
p r o p e r 
o f f s e t , 
s u b t r a c t t h e o r i g i n a l s t a r t a d d r e s s f r o m t h e new 
s t a r t 
address, 
u s i n g t h e " - " command. The [ W I o p t i o n s p e c i f i e s t h a t a 
t a b l e 
of 
t w o - b y t e v e c t o r s (Words) i s b e i n g s e a r c h e d r a t h e r t h a n 
ML 
code. 
See t h e c h a p t e r on r e u s i n g t h e t a p e r o u t i n e s i n t h e KERNAL f o r an 
example o f u s i n g t h i s command. 


0 i n s t r - a d d r t a r g e t - a d d r 
- 
(OFFSET) 
Used 
t o 
c a l c u l a t e 
t h e 
o f f s e t f o r b r a n c h i n s t r u c t i o n s . I n s t r - a d d r i s t h e a d d r e s s o f 
t h e 
b r a n c h i n s t r u c t i o n i t s e l f and t a r g e t - a d d r where y o u 
want 
i t t o 
b r a n c h 
t o . 
T h i s 
command 
i s p r e t t y 
u s e l e s s 
s i n c e 
M I C R O M O N 
a u t o m a t i c a l l y c a l c u l a t e s t h e o f f s e t f o r y o u when y o u 
assemble 
a 
b r a n c h 
i n s t r u c t i o n . 
D o n ' t 
u s e 
t h i s 
command 
f o r 
c a l c u l a t i n g 
o f f s e t s f o r t h e " N u command. 


$ hhhh - 
(HEX CONVERSION) 
C o n v e r t s t h e hex 
number 
hhhh 
i n t o 
d e c i m a l , ASCII c h a r a c t e r s and b i n a r y . 


X ddddd - 
(DECIMAL 
CONVERSION) 
C o n v e r t s 
t h e 
d e c i m a l 
number 
ddddd i n t o hex, ASCII c h a r a c t e r s and b i n a r y . 


X bbbbbbbb - 
(BINARY CONVERSION) 
C o n v e r t s 
t h e 
b i n a r y 
number 
bbbbbbbb i n t o hex, d e c i m a l , and A S C I I c h a r a c t e r s . 


" a - 
( A S C I I CONVERSION) 
C o n v e r t s t h e ASCII c h a r a c t e r 
a 
i n t o 
hex, d e c i m a l and b i n a r y . 


+ hhhh hhhh - 
(HEX ADDITION) 
Adds 
t h e 
t w o 
hex 
numbers 
and 
g i v e s a o n e - b y t e hex r e s u l t . I f t h e r e s u l t i s o v e r 
$FFFF, 
o n l y 
t h e l o w b y t e i s g i v e n . 
- hhhhhhhh - 
(HEX 
SUBTRACTION) 
S u b t r a c t s 
t h e 
second 
hex 
number f r o m t h e f i r s t . 


L s t a r t end - 
(CHECKSUM) 
Checksums an a r e a o f memory by ADDing 


t o g e t h e r a l l o f t h e b y t e s . The 
r e s u l t 
i s l i m i t e d 
t o t w o 
hex 
b y t e s . 
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THE 6510 AND THE PLA 


Bear w i t h us i n t h i s 
c h a p t e r . 
T h i s 
i n f o r m a t i o n 
c a n 
g e t 
v e r y 
c o n f u s i n g . I t i s i m p o r t a n t t o have a t l e a s t a b a s i c u n d e r s t a n d i n g 
o f how t h e m i c r o p r o c e s s o r 
and 
t h e 
a s s o c i a t e d 
memory 
c i r c u i t s 
work. We a r e n o t g o i n g t o make an e l e c t r o n i c s e n g i n e e r o u t o f t h e 
r e a d e r . We a r e o n l y g o i n g g i v e y o u some i d e a s on how t h e computer 
works. We 
w i l l use some b i g f a n c y words i n t h i s 
c h a p t e r . 
D o n ' t 
t r y t o remember a l l o f them. We w i l l e x p l a i n t h e i m p o r t a n t 
t e r m s 
and c o n c e p t s . 


The C-64 uses t h e 6510 as i t s m i c r o p r o c e s s o r c h i p . 
The 
6510 
i s 
c l o s e l y r e l a t e d t o t h e 
more 
common 
6502 
m i c r o p r o c e s s o r . 
The 
6 5 1 0 ' s 
i n t e r n a l 
a r c h i t e c t u r e 
i s v e r y 
s i m i l a r 
t o 
t h e 
MOS 
T e c h n o l o g y v e r s i o n o f t h e 
6502. 
T h i s 
i s t o 
p r o v i d e 
s o f t w a r e 
c o m p a t i b i l i t y . 
B o t h 
t h e 
6502 
and 
t h e 
6510 
use 
t h e 
same 
i n s t r u c t i o n s e t . The m o s t i m p o r t a n t d i f f e r e n c e between 
t h e 
6510 
and t h e 6502 i s t h e e i h t b i t B i - d i r e c t i o n a l 110 p o r t f e a t u r e 
o f 
t h e 6510. A c t u a l l y , on 9 y s i x b i t s ( 1 1 0 l i n e s ) 
a r e 
a v a i l a b l e 
i n 
t h e v e r s i o n used i n t h e C-64. 
The o t h e r t w o b i t s o f t h e 1 / 0 
p o r t 
have been r e s e r v e d f o r t h e Non Maskable I n t e r r u p t and 
t h e 
Ready 
l i n e s . 


Ok, 
l e t ' s t r y t o u n d e r s t a n d what a l l t h o s e b i g f a n c y words 
mean. 
F i r s t o f a l l l e t ' s 
d e f i n e 
j u s t 
what 
a 
m i c r o p r o c e s s o r 
i s . 
A 
m i c r o p r o c e s s o r i s t h e c e n t r a l p r o c e s s i n g u n i t 
o f 
t h e 
computer. 
The m i c r o p r o c e s s o r w i l l p e r f o r m 
a 
l a r g e 
number 
o f 
f u n c t i o n s , 
i n c l u d i n g : 


1. G e t t i n g i n s t r u c t i o n s and d a t a f r o m memory. 


2. Decoding i n s t r u c t i o n s . 


3. P e r f o r m i n g a r i t h m e t i c and l o g i c o p e r a t i o n s s p e c i f i e d b y 
t h e 
i n s t r u c t i o n s . 


4. 
P r o v i d i n g t i m i n g and c o n t r o l s i g n a l s f o r a l l t h e 
components 
of t h e computer. 


5. T r a n s f e r r i n g d a t a t o and f r o m I n p u t & O u t p u t 
( I / O ) 
d e v i c e s 
( p r i n t e r s , d i s k d r i v e , m o n i t o r , k e y b o a r d , e t c . ) . 


6. Responding t o s i g n a l s 
f r o m 
t h e 
110 
d e v i c e s 
( i n t e r r u p t s , 
e t c ) . 


The 6510 p r o c e s s o r w i l l p e r f o r m t h e s e f u n c t i o n s based 
upon 
what 
t h e p r o g r a m i n s t r u c t i o n s t e l l t h e p r o c e s s o r t o do. T h i s 
i s what 
makes t h e computer so 
f l e x i b l e . 
When 
we 
want 
t o 
change 
t h e 
f u n c t i o n o f t h e computer, a l l we have t o do i s g i v e t h e 
computer 
new i n s t r u c t i o n s ( s u c h as a p r o g r a m ) . The 6510 w i l l 
p e r f o r m 
any 
c o m b i n a t i o n s o f f u n c t i o n s based s o l e l y upon t h e i n s t r u c t i o n s t h a t 
i t r e c e i v e s . 
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The 6510 can address u p t o 64K (65536 bytes) of memory. 
This 
i s 
the maximum number of addresses (memory l o c a t i o n s ) t h a t the 
6510 
can look a t any one time. A memory location i s an 
area 
in 
the 
computer t h a t can contain ( s t o r e ) a value. The value contained in 
each memory location must be between 0 and 
255 
($00 t o 
$FF). 


These memory locations are where the 
computer 
program 
will 
be 
stored. The memory can e i t h e r be i n RAM (Random Access Memory) or 
in ROM (Read Only Memory). I t does not matter t o the computer 
i f 
the program resides permanently on a computer chip ( R O M ) or 
will 
be erased when t h e power i s l o s t ( R A M ) . 


The C-64 contains a f u l l 64K of RAM a n d i t contains another 1 K of 
4-bit Color RAM. 
I t also contains a 
f u l l 
20K 
of 
ROM. 
Wait 
a 
minute, 64K + 1 K + 20K = 85K. The 6510 can only address a maximum 
of 64K!! How i s i t possible t h a t we have 85K 
of 
memory 
in 
the 


C-64?? 
Well, the 6510 microprocessor can only see 64k of 
memory 
a t any one time. The r e s t 
of 
t h e memory 
i s hidden 
from 
the 
microprocessor by a device known as a Program Logic Array 
( P L A ) . 


The P L A 
will 
switch 
various 
sections 
of 
memory 
in 
or 
out 
depending upon the s p e c i f i c requirements of t h e computer. 


The function 
of 
the 
microprocessor 
a n d 
the 
P L A 
i s 
a 
very 
important r e l a t i o n s h i p t h a t should be 
understood. 
Quite 
simply 
the P L A will turn one section of memory on a n d another o f f , based 
upon the requirements of t h e program. If t h e programmer wants the 
microprocessor 
t o 
see 
RAM 
a t the 
memory 
location 
normally 
occupied by BASIC R O M , a l l the programmer has t o do i s change t h e 
value stored in memory location $0001. Memory location 
$0001 
i s 
the eight ( s i x ) b i t 1/0 r e g i s t e r . Based upon t h e b i t 
pattern 
in 
location $0001 the P L A will automatically reconfigure 
memory 
by 
enabling and/or disabling the proper memory c h i p ( s ) . Memory 
may 
also be reconfigured through the P L A by i n s t a l l i n g a c a r t r i d g e in 
the computer. J u s t as we can change the memory 
configuration 
by 
changing location $0001, we 
can 
accomplish 
the 
same 
task 
by 
grounding the E X R O M and/or GAME l i n e s of t h e c a r t r i d g e port. 


We 
have now established t h a t the C-64 does contain 85K of 
memory 
a n d t h a t the 6510 processor can access only 64K of i t a t a time. 
By simply having the P L A enable or disable the various chips, the 
computer can see d i f f e r e n t memory a t the same location. 
The 
P L A 
may be controlled e i t h e r by software ( a computer program) 
or 
by 
hardware ( t h e c a r t r i d g e board). 


Now t h a t we have a basic understanding of how 
t h e 
P L A 
a n d 
the 
microprocessor function, l e t ' s see w h a t happens on power-up. 


When we f i r s t turn our computer on, t h e 6510 microprocessor 
will 
s e t i t s L O R A M , HIRAM and the C H A R E N l i n e s high. For our 
purposes 
we will consider a l i n e t o be high when i t i s 5 v o l t s (appx.) and 
a l i n e i s said t o be low when i t i s a t 0 v o l t s . The computer will 
i n t e r p r e t a l i n e t h a t i s high as a binary 1 a n d i n t e r p r e t a 
l i n e 
t h a t i s low as a binary 0. The program counter, the stack pointer 
a n d 
the 
f l a g s 
of 
t h e 
s t a t u s 
r e g i s t e r 
will 
a l l 
contain 
indeterminate (random) values. A t t h i s point 
t h e microprocessor 
i s l o s t . Since none of the r e g i s t e r s r e t a i n any information a f t e r 
power i s turned o f f , a l l values will have t o be r e s e t before 
any 
meaningful data may be processed. 
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How t h e n , does t h e computer r e s e t t h e s e v a l u e s ? 
W i t h a RESET, of 
c o u r s e ! The C-64 c o n t a i n s 
a 
s p e c i a l 
c i r c u i t 
t h a t 
f o r c e s 
t h e 
computer t o RESET upon power-up. 
E v e r y t i m e t h e power 
i s t u r n e d 
on, t h e m i c r o p r o c e s s o r w i l l be RESET. T h i s i s e x a c t l y 
t h e 
same 
RESET c o n d i t i o n as when y o u p r e s s y o u r 
r e s e t 
b u t t o n 
( p r o v i d i n g 
you have i n s t a l l e d one). 


When t h e computer i s RESET t h e m i c r o p r o c e s s o r w i l l s e t t h e LORAM, 
H I R A M and CHAREN l i n e s h i g h ( t 5 v ) and t h e m i c r o p r o c e s s o r w i l l 
do 
an i n d i r e c t jump t o t h e address 
c o n t a i n e d 
a t 
memory 
l o c a t i o n s 


$FFFC and $FFFD. These two l o c a t i o n s make up a VECTOR. 
A 
VECTOR 
does n o t c o n t a i n 
t h e 
a c t u a l 
r o u t i n e 
t h a t 
t h e 
computer 
w i l l 
e x e c u t e upon RESET. What t h i s VECTOR does c o n t a i n i s t h e LOCATION 
where t h e RESET 
r o u t i n e 
may 
be 
found. 
I n o t h e r 
words, 
t h e 
l o c a t i o n s $FFFC and $FFFD w i l l t e l l t h e computer 
where 
t o 
f i n d 
t h e a c t u a l RESET r o u t i n e . On t h e C-64 t h e memory 
l o c a t i o n 
$FCE2 


(64738 d e c i m a l ) i s t h e a c t u a l e n t r y p o i n t i n t o t h e RESET r o u t i n e . 
We w i l l c o v e r t h e RESET r o u t i n e t h a t t h e C-64 uses l a t e r i n t h i s 
manual, so we w i l l n o t c o v e r i t i n d e p t h here. I t i s i m p o r t a n t t o 
n o t e t h a t 
t h e 
s o f t w a r e 
RESET 
(SYS 
64738 
o r 
JMP 
$FCE2) 
i s 
d i f f e r e n t from t h e hardware RESET ( a c t u a l l y 
r o u n d i n g 
t h e 
RESET 
l i n e o f t h e m i c r o p r o c e s s o r ) . The hardware R E 4 ET w i l l p e r f o r m 
a l l 
o f t h e f u n c t i o n s o f t h e s o f t w a r e RESET b u t f i r s t i t w i l l s e t 
t h e 


LORAM, t h e H I R A M and t h e CHAREN l i n e s h i g h . Any 
r e f e r e n c e s 
made 
i n t h i s c h a p t e r t o a RESET r e f e r s 
t o 
a 
hardware 
RESET 
u n l e s s 
o t h e r w i s e n o t e d . 


As you can see, t h e computer w i l l " l o o k " t o t h e 
memory 
l o c a t i o n 


$FFFC and $FFFD f o r i t s RESET 
VECTOR. 
I f we 
were 
t o 
' b u r n ' 
o u r s e l v e s a new KERNAL ROM (EPROM) 
and 
s u b s t i t u t e i t f o r 
t h e 
o r i g i n a l ROM, we would be a b l e t o f o r c e t h e computer t o p e r f o r m a 
d i f f e r e n t RESET r o u t i n e . It must be n o t e d t h a t i f we w i s h t o 
use 
an a l t e r n a t e RESET r o u t i n e i t w i l l be i m p o r t a n t t o p e r f o r m a 
few 
s p e c i f i c f u n c t i o n s e a r l y on i n o u r r o u t i n e . 


1. S E I - S e t t h e I R Q i n t e r r u p t d i s a b l e . 


2. The s t a c k p o i n t e r s h o u l d be s e t t o a s p e c i f i c v a l u e ( u s u a l l y 
$FF 1. 


3. The Decimal f l a g s h o u l d be c l e a r e d (CLD). 


4. The C a r r y f l a g s h o u l d be e i t h e r s e t o r c l e a r e d ( a s r e q u i r e d ) 
p r i o r t o p e r f o r m i n g any a r i t h m e t i c f u n c t i o n s . 


5. C l e a r t h e i n t e r r u p t p r i o r t o l e a v i n g t h e RESET r o u t i n e . 


These a r e f u n c t i o n s t h a t s h o u l d ( m u s t ) be p e r f o r m e d i n any 
RESET 
r o u t i n e . 


We have e s t a b l i s h e d t h a t t h e m i c r o p r o c e s s o r must 
be 
RESET 
upon 
power-up. Now l e t ' s f i n d o u t why t h e m i c r o p r o c e s s o r l o o k s t o 
ROM 
f o r i t s RESET r o u t i n e r a t h e r t h a t l o o k i n g t o RAM. 
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E a r l i e r we m e n t i o n e d t h a t t h e 6510 c o n t a i n s an 8 - b i t I n p u t / O u t p u t 
( I / O ) p o r t . I n t h e v e r s i o n o f t h e 
6510 
m i c r o p r o c e s s o r 
t h a t 
i s 
c o n t a i n e d i n t h e C-64 o n l y 6 l i n e s a r e used f o r 
I / O . 
The 
o t h e r 
t w o l i n e s a r e used f o r o t h e r p u r p o s e s (NMI and READY l i n e s ) . Each 
of t h e s e s i x l i n e s c o r r e s p o n d t o b i t s o f memory 
l o c a t i o n 
$0001. 
I f we 
c o n s u l t 
f i g u r e 
6-1 
we 
c a n 
see 
s i x 
p i n s 
o f 
t h e 
m i c r o p r o c e s s o r t h a t a r e l a b e l e d PO, 
P I , P2, P3, P4, 
& 
P5. 
These 
p i n s c o r r e s p o n d t o b i t s 
0 
t h r u 
5 
o f 
memory 
l o c a t i o n 
$0001, 
r e s p e c t i v e l y ( i . e . 
PO w i l l r e f l e c t b i t 0 e t c . ) . 


F u r t h e r e x p l a n a t i o n o f j u s t what an 110 p o r t i s r e q u i r e d . An 
1 / 0 
p o r t i s a s p e c i a l a r e a o f t h e m i c r o p r o c e s s o r t h a t i s r e s e r v e d f o r 
communications w i t h o t h e r d e v i c e s . It c o n s i s t s o f a f e w 
s e l e c t e d 
l i n e s ( p i n s ) o f t h e m i c r o p r o c e s s o r 
t h a t 
may 
b e 
c o n t r o l l e d 
b y 
a n o t h e r d e v i c e (when t h e l i n e s a c t as i n p u t s ) OR t h e l i n e s may be 
used t o c o n t r o l o t h e r d e v i c e s (when t h e l i n e s 
a c t 
as 
o u t p u t s ) . 
When any 1 / 0 
l i n e 
i s s e t 
t o 
input, 
t h e 
m i c r o p r o c e s s o r 
w i l l 
a u t o m a t i c a l l y sense any change i n t h e 
v a l u e s 
( v o l t a g e 
l e v e l s ) 
p l a c e d on t h i s l i n e b y o t h e r d e v i c e s . A 
change 
i n t h e 
v o l t a g e 
l e v e l a p p l i e d t o t h e l i n e w i l l cause 
t h e 
c o r r e s p o n d i n g 
b i t 
i n 
memory l o c a t i o n $0001 t o change. I f t h e v o l t a g e a p p l i e d t o one of 
t h e s e p i n s i s 5 v o l t s , t h e m i c r o p r o c e s s o r w i l l i n t e r p r e t t h i s 
as 
a 1 and change t h e a p p r o p r i a t e b i t i n l o c a t i o n $0001 t o 
a 
v a l u e 
of 1. C o r r e s p o n d i n g l y , when an 1 / 0 l i n e 
i s s e t 
t o 
o u t p u t 
t h e 
m i c r o p r o c e s s o r w i l l " l o o k " t o memory l o c a t i o n $0001 and 
s e t 
t h e 
a p p r o p r i a t e o u t p u t l i n e h i g h ( t 5 v ) o r l o w 
(Ov) 
based 
upon 
t h e 
a p p r o p r i a t e b i t i n $0001. 


We have e s t a b l i s h e d t h a t l o c a t i o n $0001 i s t h e a c t u a l 
110 
p o r t . 
We now need t o know how t o 
s w i t c h 
t h e s e 
l i n e s 
f r o m 
I n p u t 
t o 
O u t p u t . T h i s i s c o n t r o l l e d b y memory l o c a t i o n $0000. I f a b i t 
o f 
memory l o c a t i o n $0000 i s s e t t o a 1, 
t h e 
c o r r e s p o n d i n g 
b i t o f 
l o c a t i o n $0001 i s s e t t o an o u t p u t . L i k e w i s e , i f a b i t o f 
memory 
l o c a t i o n $0000 i s s e t t o a 0, t h e c o r r e s p o n d i n g b i t o f 
l o c a t i o n 
$0001 w i l l be s e t t o I n p u t . F o r example, 
i f we 
s e t 
b i t 0 
o f 
l o c a t i o n $0000 t o a 1, b i t 0 o f l o c a t i o n $0001 w i l l be an o u t p u t . 
Each l i n e o f t h e 110 p o r t may be s e t i n d e p e n d e n t l y o f 
t h e 
o t h e r 
l i n e s . Memory l o c a t i o n s $0000 and $0001 a r e c o n t a i n e d " o n 
b o a r d " 
t h e m i c r o p r o c e s s o r . When we l o a d 
o r 
s t o r e 
a 
v a l u e 
i n memory 
l o c a t i o n s $0000 o r $0001 i t w i l l 
a c t u a l l y 
be 
done 
i n s i d e 
t h e 
m i c r o p r o c e s s o r . A l l o t h e r memory l o c a t i o n s 
a r e 
o u t s i d e 
o f 
t h e 
m i c r o p r o c e s s o r i n t h e " n o r m a l " RAM o r ROM o r 110 d e v i c e s . 


As we s a i d b e f o r e , o n l y s i x l i n e s o f t h e 1 / 0 p o r t a r e used b y t h e 
m i c r o p r o c e s s o r as a c t u a l 110 l i n e s . T h r e e o f t h e 
s i x 
1 / 0 
l i n e s 
a r e used o n l y f o r t h e c a s s e t t e r e c o r d e r and w i l l n o t be d i s c u s s e d 
any f u r t h e r (P3, P4 & P5 a r e f o r t h e c a s s e t t e ) . L i n e s PO, 
P1 & P2 
a r e used b y t h e m i c r o p r o c e s s o r t o c o n t r o l access t o 
t h e 
v a r i o u s 
a r e a s o f memory 
v i a 
t h e 
PLA. 
R e f e r 
t o f i g u r e 
6-1 
f o r 
t h e 
f o l l o w i n g d i s c u s s i o n . On power up o r on RESET, 
t h e m i c r o p r o c e s s o r 
w i l l a u t o m a t i c a l l y s e t l i n e s PO, 
P I , & P2 t o 
o u t p u t s 
and 
f o r c e 
them h i g h ( t 5 v ) . T h i s s h o u l d be c o n s i d e r e d as t h e " n o r m a l " 
s t a t e 
o f t h e m i c r o p r o c e s s o r . 
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D u r i n g a RESET, t h e RESET r o u t i n e w i l l 
v e r i f y 
t h a t 
t h e 
p r o p e r 
l i n e s a r e s e t t o o u t p u t s and t h a t t h e y c o n t a i n t h e p r o p e r 
v a l u e s 
by s t o r i n g t h e a p p r o p r i a t e v a l u e s a t l o c a t i o n s $0000 & $0001. 
If 
we examine memory a f t e r a RESET, we w i l l see t h a t l o c a t i o n 
$0001 
c o n t a i n s a v a l u e o f $37. The l o w n i b b l e ( 7 ) i n d i c a t e s 
t h a t 
b i t s 
0, 
1 & 2 a r e i n d e e d s e t 
h i g h . 
We 
w i l l 
a l s o 
see 
t h a t 
memory 
l o c a t i o n $0000 c o n t a i n s $2F. The l o w n i b b l e 
( F ) 
i n d i c a t e s 
t h a t 
l i n e s PO, 
P I , P2, & P3 a r e s e t t o o u t p u t s . 


We have a l r e a d y m e n t i o n e d t h a t 
t h e 
PLA 
c o n t r o l s 
t h e 
a r e a 
o f 
memory t h a t t h e 
m i c r o p r o c e s s o r 
w i l l 
see. 
L e t ' s 
t a k e 
a more 
s p e c i f i c l o o k a t what c o n t r o l s t h e PLA. E a r l i e r we mentioned t h a t 
upon power up o r RESET t h e LORAM, t h e H I R A M and t h e CHAREN 
l i n e s 
o f t h e 
m i c r o p r o c e s s o r 
w i l l 
be 
s e t 
h i g h 
( + 5 v ) . 
These 
l i n e s 
c o r r e s p o n d t o t h r e e b i t s o f memory l o c a t i o n $0001 ( b i t s 00, 01 
& 


02 r e s p e c t i v e l y ) . 


L i n e PO i s t h e LORAM l i n e . N o r m a l l y t h i s l i n e i s h i g h ( t 5 v ) . 
The 


LORAM 
l i n e c o n t r o l s 
t h e 
B A S I C 
i n t e r p r e t e r 
memory 
o n l y 


($A000-$BFFF). When t h e LORAM l i n e i s h i g h 
( t 5 v ) 
t h e 
PLA 
w i l l 
cause t h e m i c r o r o c e s s o r 
t o 
see 
BASIC 
ROM 
a t 
t h i s 
l o c a t i o n 


($AOOO-$BFFF). 
Rhen t h e LORAM l i n e i s l o w (Ov) t h e PLA w i l l cause 
t h e m i c r o p r o c e s s o r t o see R A M a t t h i s l o c a t i o n ($A000-$BFFF). 
We 
can e a s i l y c o n t r o l t h e LORAM l i n e by 
c h a n g i n g 
memory 
l o c a t i o n 
$0001 f r o m a $37 t o a $36 ( s e t t i n g b i t 0 t o a 0 ) . 


L i n e P I i s t h e H I R A M l i n e . N o r m a l l y t h i s l i n e i s h i g h ( t 5 v ) . 
The 
H I R A M l i n e c o n t r o l s t h e KERNAL 
memory 
($E000-$FFFF) 
and 
BASIC 
memory ($A000-$BFFF). When t h e H I R A M l i n e i s h i g h ( t 5 v ) , t h e 
PLA 
w i l l cause t h e m i c r o p r o c e s s o r t o see KERNAL ROM a t t h i s 
l o c a t i o n 


($E000-$FFFF) and a l l o w s LORAM t o c o n t r o l 
B A S I C 
ROM. 
When 
t h e 
H I R A M l i n e i s l o w (Ov) t h e PLA w i l l cause t h e 
m i c r o p r o c e s s o r 
t o 
see 
RAM 
a t 
BOTH 
KERNAL 
AND 
BASIC 
AREAS 
($A000-$BFFF 
AND 


$E000-$FFFF). 
We can e a s i l y c o n t r o l t h e H I R A M 
l i n e by 
c h a n g i n g 
memory l o c a t i o n $0001 f r o m a $37 t o a $35 ( s e t t i n g b i t 1 
t o 
0 ) . 


Be s u r e t o s e t t h e i n t e r r u p t ( S E I ) p r i o r 
t o 
s e t t i n g 
t h e 
H I R A M 
l i n e l o w and t h e n c l e a r t h e i n t e r r u p t ( C L I ) 
upon 
r e s e t t i n g 
t h e 
H I R A M h i g h . 


It i s i m p o r t a n t t o n o t e t h a t i f we t u r n o f f 
t h e 
KERNAL 
ROM 
i t 
w i l l a l s o cause t h e BASIC ROM t o be t u r n e d o f f . I f t h e 
computer 
i s c o n f i g u r e d , u s i n g H I R A M , t o see R A M 
a t 
$E000-$FFFF 
i t w i l l 
a l s o see R A M a t $A000-$BFFF. 
Remember t h a t B A S I C 
may 
be 
t u r n e d 
o f f by i t s e l f ( w i t h LORAM), b u t i f we t u r n 
o f f 
t h e 
KERNAL 
ROM 
( w i t h HIRAM) we w i l l a l s o t u r n o f f t h e B A S I C R O M ! ! ! 
If l i n e P O (LORAM) and P I (HIRAM) a r e b o t h s e t l o w 
(Ov) 
a 
v e r y 
i n t e r e s t i n g t h i n g w i l l o c c u r . The computer w i l l now be c o n f i g u r e d 
t o see a l l 64K o f RAM. The KERNAL ROM, 
t h e BASIC ROM and t h e 
1/0 
d e v i c e s 
a t 
$D000-$DFFF 
w i l l 
a l l 
be 
s w i t c h e d 
o u t . 
The 
m i c r o p r o c e s s o r 
w i l l 
now 
see 
o n l y 
t h e 
64K 
o f 
RAM. 
T h i s 
c o n f i g u r a t i o n w i l l a l l o w t h e m i c r o p r o c e s s o r t o 
use 
a l l 
64k 
o f 
RAM. We can e a s i l y c o n t r o l b o t h t h e H I R A M and t h e LORAM l i n e s 
by 
s t o r i n g a v a l u e o f $34 a t memory l o c a t i o n 
$0001. 
Keep 
i n mind 
t h a t t h e u s e r w i l l have t o s w i t c h t h e 110 d e v i c e s a t 
$D000-$DFFF 


back i n f o r any 1 / 0 o p e r a t i o n s (communications w i t h 
t h e 
screen, 
d i s k d r i v e , keyboard, e t c . ) . 
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L i n e P2 i s t h e CHAREN l i n e . N o r m a l l y t h i s l i n e i s h i g h ( t 5 v ) . The 
CHAREN l i n e c o n t r o l s t h e 1 / 0 d e v i c e s 
a t 
$D000-$DFFF. 
When 
t h e 


CHAREN l i n e i s h i g h t h e m i c r o p r o c e s s o r w i l l see 1 / 0 d e v i c e s 
(VIC 


c h i p , S I D c h i p and t h e C I A s ) a t t h i s a r e a 
o f 
memory. 
When 
t h e 


CHAREN l i n e i s l o w 
(Ov) 
t h e 
m i c r o p r o c e s s o r 
w i l l 
see 
t h e 
4k 
c h a r a c t e r g e n e r a t o r ROM a t t h i s l o c a t i o n . The computer 
w i l l 
n o t 
be a b l e t o access any 1 / 0 d e v i c e s i f t h e CHAREN l i n e i s low. 
The 
o n l y t i m e t h a t t h e CHAREN l i n e w o u l d n o r m a l l y be h e l d l o w 
i s i f 
t h e u s e r w i s h e d t o download t h e c h a r a c t e r ROM t o RAM. 
To s e t 
t h e 


CHAREN l i n e l o w a1 1 one has t o do i s t o 
change 
memory 
l o c a t i o n 
$0001 f r o m $37 t o $33 ( s e t t i n g b i t 3 t o 0 ) . 


We have now c o v e r e d a l l 
t h e 
s o f t w a r e 
s e l e c t i o n s 
o f 
t h e 
PLA. 
Remember t h a t t h e PLA w i l l s e l e c t a s p e c i f i c a r e a o f memory based 
upon t h e r e q u i r e m e n t s o f t h e m i c r o p r o c e s s o r . A l l one has t o do i s 
t o s e t b y t e $0001 t o a s p e c i f i e d v a l u e and t h e PLA 
w i l l 
do 
t h e 
r e s t . B e f o r e we p r o c e e d i n t o t h e h a r d w a r e 
c o n t r o l 
o f 
t h e 
PLAY 


l e t ' s t a k e a l o o k a t t h e n o r m a l 
sequence 
o f 
o p e r a t i o n 
o f 
t h e 
m i c r o p r o c e s s o r . 


When t h e m i c r o p r o c e s s o r i s i n o p e r a t i o n t h e program c o u n t e r 
w i l l 
keep t r a c k 
o f 
t h e 
memory 
l o c a t i o n 
t h a t 
i s c u r r e n t l y 
b e i n g 
accessed. The f o l l o w i n g i s a b r i e f d e s c r i p t i o n o f t h e sequence o f 
e v e n t s t h a t o c c u r s when t h e m i c r o p r o c e s s o r g e t s a 
b y t e 
o f 
d a t a 
f r o m memory. 


1. The m i c r o p r o c e s s o r w i l l send o u t t h e a d d r e s s o f t h e 
c u r r e n t 
b y t e o f memory t h a t i s r e q u e s t e d . 
The 
m i c r o p r o c e s s o r 
w i l l 
a l s o s p e c i f y i f t h e b y t e i s g o i n g 
t o 
be 
r e a d 
o r 
t o 
be 
w r i t t e n . I n t h i s example we w i l l assume a r e a d o f d a t a 
(LDA 
- LoaD t h e A c c u m u l a t o r ) . 


2. The PLA w i l l decode t h e a d d r e s s 
s p e c i f i e d 
b y 
t h e 
p r o g r a m 
c o u n t e r 
and 
s e l e c t 
( e n a b l e ) 
t h e 
c h i p 
r e q u i r e d 
b y 
t h e 
m i c r o p r o c e s s o r . 


3. The s e l e c t e d memory c h i p w i l l decode t h e 
a d d r e s s 
s p e c i f i e d 
b y t h e m i c r o p r o c e s s o r 
and 
s e l e c t 
t h e 
a p p r o p r i a t e 
memory 
l o c a t i o n f r o m w i t h i n t h e c h i p . 


4. The s e l e c t e d c h i p t h e n makes 
t h e 
d a t a 
a v a i l a b l e 
and 
t h e 
m i c r o p r o c e s s o r l o a d s t h e d a t a i n t o t h e a p p r o p r i a t e r e g i s t e r . 


A l l o f t h i s sounds p r e t t y t i m e consuming, d o e s n ' t i t ? ? 
A c t u a l l y 
t h e t i m e r e q u i r e d t o f e t c h a b y t e o f d a t a f r o m memory t a k e s 
l e s s 
t h a n 1 m i l l i o n t h (1/1,000,000) 
o f 
a 
second 
i n t h e 
C-64. 
The 
i n s t r u c t i o n JMP $4000 (4C 00 40) t a k e s o n l y 
3 
m i l l i o n t h s 
o f 
a 
second t o e x e c u t e . 1 m i l l i o n t h i s used t o f e t c h 
and 
decode 
t h e 
i n s t r u c t i o n (4C), 1 m i l l i o n t h t o 
f e t c h 
t h e 
l o w 
b y t e 
(001, 
1 
m i l l i o n t h t o f e t c h t h e h i g h b y t e ( 4 0 ) and p l a c e t h e s e 
v a l u e s 
on 
t h e p r o g r a m c o u n t e r . Thus a JMP i n s t r u c t i o n 
i s a c c o m p l i s h e d 
i n 
o n l y t h r e e c l o c k c y c l e s . 
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HARDWARE CONTROL OF THE PLA 


The memory t h a t t h e m i c r o p r o c e s s o r sees may a l s o be c o n t r o l l e d by 
hardware. Hardware c o n t r o l r e q u i r e s an a c t u a l c o n n e c t i o n f r o m t h e 
p i n s on t h e c a r t r i d g e p o r t t o ground. Two o f t h e l i n e s 
c o n n e c t e d 
f r o m 
t h e 
PLA 
t o 
t h e 
c a r t r i d g e 
p o r t 
w i l l 
c o n t r o l 
memory 
c o n f i g u r a t i o n . The PLA w i l l m o n i t o r t h e v o l t a g e 
l e v e l 
o f 
t h e s e 
t w o l i n e s . These t w o l i n e s a r e c a l l e d t h e EXROM l i n e and t h e GAME 
l i n e . These t w o l i n e s a r e n o r m a l l y h i g h ( + 5 v ) . 
When 
e i t h e r 
( o r 
b o t h ) o f t h e s e l i n e s a r e grounded t h e PLA 
w i l l 
r e c o n f i g u r e 
t h e 
memory t h a t t h e m i c r o p r o c e s s o r sees. 


G r o u n d i n g o n l y t h e E X R O M l i n e w i l l cause t h e PLA 
t o 
r e c o n f i g u r e 
memory so t h a t t h e m i c r o p r o c e s s o r w i l l l o o k t o t h e c a r t r i d g e p o r t 
t o f i n d t h e memory f r o m $8000-$9FFF. 
A l l 
o f 
t h e 
o t h e r 
memory 
l o c a t i o n s w i l l r e m a i n i n t a c t . BASIC ROM, 
KERNAL ROM and 
t h e 
110 


d e v i c e s w i l l r e m a i n i n e f f e c t . 
Under 
normal 
c i r c u m s t a n c e s 
t h e 
EXROM l i n e w o u l d 
be 
grounded 
o n l y 
i f a 
c a r t r i d g e 
had 
been 
i n s t a l l e d . I f we 
were 
t o 
g r o u n d 
t h e 
E X R O M 
l i n e w i t h o u t 
a 
c a r t r i d g e i n s t a l 1 ed t h e m i c r o p r o c e s s o r w o u l d n o t f i n d any 
memory 
a t t h e s e l o c a t i o n s ($8000-$9FFF). The PLA does n o t 
c a r e 
i f any 
memory e x i s t s a t t h e memory l o c a t i o n s t h a t t h e m i c r o p r o c e s s o r 
i s 
l o o k i n g a t . I f we g r o u n d t h e E X R O M l i n e w i t h o u t 
p l u g g i n g 
i n a 
c a r t r i d g e , t h e PLA w i l l p r e v e n t t h e 
m i c r o p r o c e s s o r 
f r o m 
s e e i n g 
any memory o t h e r t h a n what i s a t t h e c a r t r i d g e p o r t 
( n o t h i n g 
i n 
t h i s example). The m i c r o p r o c e s s o r w i l l o n l y f i n d 
random 
g a r b a g e 
i n t h i s 
area. 
T h i s 
i s a 
way 
f o r 
t h e 
PLA 
t o 
p r e v e n t 
t h e 
m i c r o p r o c e s s o r f r o m 
s e e i n g 
t h e 
RAM 
n o r m a l l y 
a t 
$8000-$9FFF. 


REMEMBER THAT WHEN THE E X R O M LINE I S GROUNDED THE PLA WILL 
CAUSE 
THE MICROPROCESSOR TO SEE ONLY THAT MEMORY THAT I S PLUGGED 
INTO 
THE 
CARTRIDGE PORT. THIS WILL O C C U R WHETHER THERE I S A CARTRIDGE 
PLUGGED I N OR NOT! 


G r o u n d i n g o n l y t h e GAME l i n e w i l l c a u s e t h e 
PLA 
t o 
r e c o n f i g u r e 
memory so t h a t t h e 
computer 
w i l l 
be 
a b l e 
t o 
use 
c a r t r i d g e s 
d e s i g n e d f o r t h e "ULTIMAX" system. The KERNAL ROM and 
t h e 
BASIC 
ROM w i l l be s w i t c h e d o u t and t h e m i c r o p r o c e s s o r w i l l l o o k t o t h e 
c a r t r i d g e p o r t f o r memory i n t h e $8000-$9FFF and t h e 
$E000-$FFFF 


r a n g e . T h i s c o n f i g u r a t i o n o f memory w i l l c a u s e t h e m i c r o p r o c e s s o r 
n o t 
t o 
see 
ANY 
memory 
i n t h e 
f o l l o w i n g 
a r e a s 
o f 
memory; 


$1000-$7FFF and $A000-$CFFF ( ' i m a g e s ' may appear 
i n t h e s e 
open 
a r e a s ) . Memory 1 o c a t i ons $0000-$OFFF w i 11 appear 
as 
t h e 
normal 
RAM and $D000-$DFFF w i l l appear as t h e n o r m a l 
1 / 0 
d e v i c e s . 
The 
m i c r o p r o c e s s o r w i l l l o o k f o r 
memory 
l o c a t i o n s 
$8000-$9FFF 
and 


$E000-$FFFF 
on 
t h e 
c a r t r i d g e 
p o r t . 
Again, 
t h i s 
memory 
c o n f i g u r a t i o n i s o n l y 
f o r 
t h o s e 
c a r t r i d g e s 
t h a t 
e m u l a t e 
t h e 
ULTIMAX system. 


G r o u n d i n g BOTH t h e E X R O M and t h e GAME l i n e s a t t h e same t i m e w i l l 
cause t h e PLA t o r e c o n f i g u r e memory so 
t h a t 
t h e 
m i c r o p r o c e s s o r 
w i l l 
l o o k 
t o 
t h e 
c a r t r i d g e 
p o r t 
f o r 
memory 
a t 
l o c a t i o n s 


$8000-$BFFF. 
T h i s c o n f i g u r a t i o n w i l l a l l o w 
t h e 
use 
o f 
16K 
o f 
c o n t i n u o u s c a r t r i d g e memory. 8K w i l l r e s i d e i n t h e normal a r e a o f 
c a r t r i d g e memory ($8000-$9FFF). The o t h e r 8K w i l l r e s i d e 
i n t h e 
a r e a o f memory t h a t i s n o r m a l l y r e s e r v e d b y BASIC ($A000-$BFFF). 
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T h i s memory c o n f i g u r a t i o n w i l l a l s o a l l o w f o r t h e 
programmer 
t o 
s w i t c h between t h e 
RAM 
and 
ROM 
l o c a t e d 
a t 
memory 
l o c a t i o n s 


$8000-$9FFF. 
By c o n t r o l l i n g t h e LORAM 
l i n e 
t h e 
programmer 
may 
s e l e c t R A M o r c a r t r i d g e ROM. When t h e LORAM l i n e i s h i g h t h e 
PLA 
w i l l cause t h e m i c r o p r o c e s s o r t o see ROM a t l o c a t i o n $8000-$9FFF. 
When t h e LORAM l i n e i s l o w t h e PLA w i l l c a u s e t h e 
m i c r o p r o c e s s o r 
t o see R A M a t l o c a t i o n s $8000-$9FFF and t h e 
m i c r o p r o c e s s o r 
w i l l 
s t i l l see t h e c a r t r i d g e ROM 
l o c a t e d 
a t 
$A000-$BFFF. 
I n o t h e r 
words, t r y i n g t o t u r n o f f t h e BASIC ROM w i t h LORAM when GAME 
and 
EXROM a r e b o t h grounded w i l l t u r n o f f 
t h e 
c a r t r i d g e 
memory 
a t 


$8000-9FFF b u t w i l l not t u r n o f f c a r t r i d g e memory a t $A000-BFFF! 


We 
have 
now 
c o v e r e d 
t h e 
m a j o r 
f u n c t i o n s 
o f 
t h e 
PLA 
and 
m i c r o p r o c e s s o r c o m b i n a t i o n used i n t h e C-64 
as 
t h e y 
r e l a t e 
t o 
memory management. 
The 
PLA 
a l s o 
has 
a 
f e w 
o t h e r 
i m p o r t a n t 
f u n c t i o n s . When t h e m i c r o p r o c e s s o r w r i t e s t o an 
a r e a 
o f 
memory 
t h a t c o n t a i n s b o t h 
R A M 
and 
ROM 
(BASIC 
ROM 
$A000-$BFFF, 
f o r 
example) t h e PLA w i l l a l l o w t h e m i c r o p r o c e s s o r t o w r i t e 
t o t h e 
u n d e r l y i n g 
RAM. 
The 
PLA 
w i l l 
d e c o d e 
t h e 
m i c r o p r o c e s s o r ' s 
i n s t r u c t i o n s when i t i s r e a d i n g and w r i t i n g . The 
PLA 
w i l l 
t h e n 
" d e c i d e " what memory t h a t t h e m i c r o p r o c e s s o r s h o u l d 
have 
access 
t o (RAM o r ROM). I f t h e m i c r o p r o c e s s o r i s g o i n g t o w r i t e (STA) 
a 
v a l u e i n memory, t h e PLA w i l l s e l e c t t h e a p p r o p r i a t e memory 
(ROM 


c a n n o t be w r i t t e n t o ) . I f t h e 
m i c r o p r o c e s s o r 
w i l l 
be 
r e a d i n g 


(LDA) a v a l u e f r o m memory, t h e PLA w i l l s e l e c t t h e p r o p e r a r e a o f 
memory based upon t h e LORAM, 
H I R A M , EXROM and GAME l i n e s . The one 
d e v i a t i o n f r o m t h e p r e c e d i n g example i s when 
t h e 
m i c r o p r o c e s s o r 
w r i t e s 
t o 
t h e 
memory 
a t 
$D000-$DFFF. 
T h i s 
memory 
n o r m a l l y 
c o n t a i n s t h e 1 / 0 d e v i c e s , r a t h e r t h a n 
R A M 
o r 
ROM. 
Because 
o f 
t h i s , t h e PLA w i l l a l l o w t h e 
m i c r o p r o c e s s o r 
t o 
b o t h 
r e a d 
and 
w r i t e t o t h e s e a d d r e s s e s . These a d d r e s s do n o t n o r m a l l y r e f e r 
t o 
a c t u a l RAMIROM memory l o c a t i o n s used b y t h e 6510. They 
p r i m a r i l y 
c o n t a i n t h e o n b o a r d r e g i s t e r s o f t h e 1 / 0 d e v i c e s 
and 
t h e 
c o l o r 
RAM used by t h e V I C c h i p . The V I C ( v i d e o ) c h i p , t h e 
S I D 
( s o u n d ) 
c h i p , t h e C I A ' S ( c o m m u n i c a t i o n ) 
c h i p s 
and 
t h e 
c o l o r 
RAM 
a r e 
l o c a t e d i n t h i s a r e a o f memory. 


The V I C c h i p can a l s o access ( l o o k a t ) memory. The V I C 
c h i p 
c a n 
o n l y a d d r e s s 16K o f memory a t any one t i m e . 
The 
V I C 
c h i p 
a l s o 
causes t h e PLA t o s e l e c t what a r e a o f memory i s a v a i l a b l e t o 
t h e 
V I C c h i p . F o r i n s t a n c e , when t h e V I C c h i p 
w a n t s 
t o 
access 
t h e 
CHARACTER ROM, 
t h e PLA w i l l s e l e c t t h i s c h i p r a t h e r t h a n t h e 
1 / 0 
d e v i c e s n o r m a l l y l o c a t e d f r o m $D000-$DFFF. 
F o r o u r 
purposes, 
we 
have 
a l r e a d y 
c o v e r e d 
a l l 
t h a t 
we 
need 
t o 
a b o u t 
t h e 
6510 
m i c r o p r o c e s s o r and t h e PLA. 
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If 
y o u have a h a r d t i m e d i g e s t i n g a l l t h e 
i n f o r m a t i o n 
p r e s e n t e d 
t o y o u i n t h i s c h a p t e r , DON'T 
WORRY 
ABOUT 
I T ! ! ! 
A 
tremendous 
amount of i n f o r m a t i o n has been p r e s e n t e d h e r e . L e t ' s j u s t 
r e v i e w 
a few o f t h e more i m p o r t a n t c o n c e p t s : 


1 . The 6510 m i c r o p r o c e s s o r i s RESET upon power up. 


2 . Whenever t h e m i c r o p r o c e s s o r i s RESET t h e LORAM, t h e HIRAM 
and 
t h e CHAREN l i n e s w i l l b e s e t h i g h . 


3. The PLA w i l l c o n t r o l t h e m i c r o p r o c e s s o r ' s 
access 
t o 
v a r i o u s 
a r e a s o f memory. 


4. The PLA may 
be 
c o n t r o l l e d 
b y 
b o t h 
h a r d w a r e 
and 
s o f t w a r e 
methods. 


5. By g r o u n d i n g t h e E X R O M l i n e we c a n p r e v e n t t h e 
m i c r o p r o c e s s o r 
f r o m s e e i n g R A M a t l o c a t i o n s $8000-$9FFF ( v e r y i m p o r t a n t ) . 


6. A s o f t w a r e RESET (SYS 64738 o r JMP 
$FCE2) i s d i f f e r e n t t h a n 
a 
hardware RESET. 
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CARTRIDGES AND CARTRIDGE BOARDS 


There a r e two main 
ways 
t o use 
an 
E P R O M 
i n your 
Commodore 
computer system. You can use t h e E P R O M 
on 
a 
plug-in 
c a r t r i d g e 
board, o r you can use i t t o d i r e c t l y r e p l a c e one of t h e ROM c h i p s 
i n t h e computer o r d r i v e . We'll cover both of t h e s e 
t o p i c s , 
b u t 
l e t ' s c o n c e n t r a t e 
on 
c a r t r i d g e s 
f o r 
now. 
There 
a r e 
s e v e r a l 
d i f f e r e n t kinds of c a r t r i d g e s 
f o r t h e 
C-64, 
i n c l u d i n g 
e x o t i c 
c a r t r i d g e s used i n some commercial p r o d u c t s . 
To 
understand 
t h e 
d i f f e r e n c e s among c a r t r i d g e s , we need t o look a t how 
c a r t r i d g e s 
a r e recognized and accessed by t h e computer. 
Before 
proceeding, 
be s u r e you have read t h e c h a p t e r on memory management. 
In 
t h a t 
c h a p t e r we looked a t t h e P L A and i t s r e l a t i o n s h i p with 
t h e 
r e s t 
of t h e computer. In t h i s c h a p t e r w e ' l l 
look 
a t how 
c a r t r i d g e s 
i n t e r a c t with t h e P L A . 


The s i m p l e s t t y p e of c a r t r i d g e i s ' t h e 8K c a r t r i d g e . A c t u a l l y , you 
could p u t LESS t h a n 8K of EPROM on t h i s t y p e of c a r t r i d g e , b u t 8K 
i s t h e maximum, 
s o 
w e ' l l 
l o o s e l y 
c a l l 
i t t h e 
s t a n d a r d 
8K 
c a r t r i d g e . A s i n g l e 2764 E P R O M (8K) 
i s u s u a l l y 
used 
i n t h e s e 
c a r t r i d g e s (commercial c a r t r i d g e s may use 
P R O M S 
i n s t e a d ) . 
When 
t h i s t y p e of c a r t r i d g e i s plugged i n t o t h e 
computer, 
t h e 
E P R O M 
w i l l be "seen" by t h e computer a t memory a d d r e s s $8000-9FFF. 
The 
RAM which i s normally t h e r e w i l l " d i s a p p e a r " . O f 
c o u r s e , 
y o u ' l l 
g e t your RAM back when you unplug your c a r t r i d g e . 
In 
f a c t , 
t h e 
c o n t e n t s of t h e RAM w i l l be unchanged. (By t h e way, NEVER plug o r 
unplug a c a r t r i d g e when t h e computer power i s on, u n l e s s you have 
a c a r t r i d g e power s w i t c h . Doing s o could 
d e s t r o y your 
computer 
and c a r t r i d g e ! ) 


The second t y p e of c a r t r i d g e can hold up t o 16K 
of 
memory, 
s o 


w e ' l l c a l l i t t h e s t a n d a r d 16K c a r t r i d g e . Two 2764 EPROMs u s u a l l y 
supply t h e 
16K. 
The 
f i r s t 
E P R O M 
w i l l 
appear 
i n memory 
a t 


$8000-9FFF, r e p l a c i n g t h e normal RAM t h e r e . The second E P R O M w i l l 
appear a t $A000-BFFF, knocking o u t t h e BASIC ROM which i s u s u a l l y 
l o c a t e d t h e r e . This g i v e s us 16K of continuous 
c a r t r i d g e 
memory 
from $8000 t o $BFFF. I f you r e c a l l t h a t t h e BASIC ROM i s a l r e a d y 
" s i t t i n g " on t o p of 8K of R A M , you can 
a p p r e c i a t e 
how 
much 
i s 
going on behind t h e s c e n e s t o keep a l l t h i s s t r a i g h t . 


The t h i r d t y p e of c a r t r i d g e i s c a l l e d 
an 
ULTIMAX 
o r 
j u s t 
MAX 
c a r t r i d g e . ULTIMAX was a video game system produced by 
Commodore 
and s o l d o n l y i n Europe, and only f o r a s h o r t while. I t used 
t h e 
same VIC I 1 and SID c h i p s a s t h e C-64. The d e s i g n e r s of t h e 
C-64 
arranged i t s o t h a t c a r t r i d g e s f o r t h e MAX would work on t h e C-64 
too. On t h e C-64, 
MAX c a r t r i d g e s r e p l a c e t h e K E R N A L 
R O M 
l o c a t e d 
a t $E000-FFFF w i t h t h e i r own 8K of E P R O M . 
MAX c a r t r i d g e s may a l s o 
have a n o t h e r 8K of ROM memory i f d e s i r e d , which 
w i l l 
appear 
a t 


$8000-9FFF. One s p e c i a l f e a t u r e of MAX c a r t r i d g e s i s t h a t a l l 
of 
t h e RAM of t h e computer d i s a p p e a r s e x c e p t f o r 4K 
a t $0000-OFFF. 
Because we c a n ' t a c c e s s most of t h e R A M , 
MAX 
c a r t r i d g e s 
r e a l l y 
a r e n ' t u s e a b l e i n very many a p p l i c a t i o n s , 
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We j u s t s a i d 
t h a t 
t h e 
EPROMs 
i n t h e s e 
c a r t r i d g e s 
' r e p l a c e ' 
d i f f e r e n t a r e a s o f memory. T h i s i s r e a l l y 
o n l y 
t r u e 
f o r 
r e a d 
o p e r a t i o n s . W r i t e o p e r a t i o n s w i 11 v a r y i n t h e i r e f f e c t 
d e p e n d i n g 
on t h e t y p e o f c a r t r i d g e . 
F o r 
example, 
w i t h 
an 
8K 
c a r t r i d g e 
p l u g g e d i n , t h e c o m p u t e r w i l l be a b l e t o r e a d t h e c a r t r i d g e EPROM 
a t $8000. I f t h e 
c o m p u t e r 
t r i e s 
t o 
w r i t e 
t o 
t h i s 
l o c a t i o n , 
however, t h e d a t a w i l l e n d up i n t h e R A M " u n d e r " 
t h e 
c a r t r i d g e . 
L i k e w i s e , 
w i t h 
16K 
c a r t r i d g e s 
w r i t e 
o p e r a t i o n s 
go 
t o 
R A M 
a u t o m a t i c a l l y , even t h o u g h t h e second EPROM a t $A000-BFFF i s t w o 
l e v e l s removed f r o m R A M ( t h e BASIC R O M i s s a n d w i c h e d 
i n between 
t h e EPROM and RAM). W i t h M A X 
c a r t r i d g e s , 
however, 
t h e 
RAM 
i s 
t r u l y "gone". 
W r i t i n g has NO e f f e c t on 
any a r e a 
o f 
R A M 
e x c e p t 
t h e $0000-OFFF a r e a . 


How do t h e c a r t r i d g e EPROMs and RAM c h i p s know 
when 
t o 
r e s p o n d 
and when n o t t o ? Why d o e s a r e a d o p e r a t i o n 
go 
t o 
EPROM 
and 
a 
w r i t e o p e r a t i o n go t o RAM? We 
saw i n a p r e v i o u s c h a p t e r t h a t 
t h e 
C - 6 4 ' s PLA c h i p i s 
i n c h a r g e 
o f 
memory 
management. 
I n t h i s 
c h a p t e r w e ' l l see how t h e c a r t r i d g e c o n t r o l s t h e PLA 
t o 
p r o d u c e 
t h e s e e f f e c t s . A t t h e same t i m e , w e ' l l a d d r e s s a r e l a t e d t o p i c - 
what makes t h e t h r e e t y p e s o f c a r t r i d g e s d i f f e r e n t ? 
Why 
do 
t h e 
c a r t r i d g e EPROMs a p p e a r a t t h e l o c a t i o n s t h e y d o ? 


The answers t o t h e s e q u e s t i o n s l i e i n t h e EPROM's 
enable 
l i n e s . 
I n o r d e r f o r a c h i p t o b e a c t i v e , i t m u s t h a v e a s u p p l y o f power, 
f i r s t of a l l . It m u s t 
a l s o 
h a v e 
address 
and 
data 
l i n e s 
t o 
communicate t o t h e o u t s i d e w o r l d . Most c h i p s a l s o have 
a t 
l e a s t 
one enable 
1 i n e . M o s t 
o f 
t h e 
EPROMS 
d i s c u s s e d 
i n t h i s 
book 
a c t u a l l y h a v e t w o e n a b l e l i n e s , c a l l e d t h e chip enable 
(CE) 
and 
output enable (OE) l i n e s . B o t h h a v e t o b e c o n t r o l l e d c o r r e c t l y i n 
o r d e r t o a c c e s s t h e c h i p . An e n a b l e l i n e i s l i k e 
a 
s w i t c h . 
The 
c h i p e n a b l e (CE) i s a power s w i t c h . Even i f power 
i s a v a i l a b l e , 
t h e c h i p w i l l n o t become a c t i v e u n t i l t h e CE l i n e i s b r o u g h t 
l o w 
( g r o u n d e d ; s e t t o 
0 
v o l t s ) . 
The 
a b b r e v i a t i o n 
CE 
i s u s u a l l y 
w r i t t e n w i t h a b a r o v e r i t t o i n d i c a t e t h a t t h e CE l i n e 
p e r f o r m s 
i t s f u n c t i o n o n l y when i t i s b r o u g h t l o w ( t h i s i s c a l l e d 
a c t i v e 
l o w ) . When CE i s h e l d h i g h (+5 
v o l t s ) , 
t h e 
c h i p 
i s p u t 
i n t o 
" s t a n d b y " mode. 
I n t h i s mode t h e c h i p u s e s much l e s s 
power 
t h a n 
when a c t i v e . A c e r t a i n minimum amount o f power i s u s e d i n s t a n d b y 
mode t o keep t h e c h i p "warmed up". 
EPROMs d o n ' t r e q u i r e ANY power 
j u s t t o r e t a i n t h e i r d a t a . 


The o t h e r e n a b l e l i n e , o u t p u t e n a b l e (OE), 
c o n t r o l s 
t h e 
c h i p ' s 
d a t a l i n e s . OE i s u s u a l l y w r i t t e n w i t h a b a r o v e r i t t o o , 
s i n c e 
t h e c h i p w i l l o n l y p u t o u t d a t a when t h e OE l i n e i s l o w . I n o r d e r 
f o r t h e c h i p t o b e a c t i v e , b o t h OE and CE h a v e t o s e t l o w a t 
t h e 
same t i m e . On C-64 c a r t r i d g e s , t h e t w o e n a b l e l i n e s f r o m t h e c h i p 
a r e combined i n t o a s i n g l e l i n e t o make e n a b l i n g t h e c h i p e a s i e r . 
The c h i p c a n b e e n a b l e d b y s w i t c h i n g t h i s one combined l i n e 
h i g h 
o r low. C a r t r i d g e s w i t h t w o c h i p s o n b o a r d h a v e a s e p a r a t e e n a b l e 
l i n e f o r e a c h c h i p . Each e n a b l e l i n e i s a c o m b i n a t i o n o f 
t h e 
OE 
and CE l i n e s f r o m one c h i p . From now o n 
when 
we 
speak 
o f 
THE 
e n a b l e l i n e f o r a c h i p , w e ' l l b e r e f e r r i n g t o t h e c o m b i n a t i o n 
o f 
CE and OE. 
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Enable l i n e s a r e used when s e v e r a l c h i p s 
a r e 
connected 
t o t h e 
same s e t of a d d r e s s and d a t a l i n e s . I f more t h a n 
one 
c h i p 
were 
a c t i v e a t t h e same t i m e , 
t h e r e would 
be 
mass 
confusion 
(bus 
c o n f l i c t ) and p o s s i b l y even physical 
damage 
t o t h e 
c h i p s . 
By 
c o n t r o l l i n g t h e e n a b l e l i n e s , you can make s u r e o n l y one c h i p 
a t 
a time w i l l be a c t i v e on t h e a d d r e s s and d a t a 
l i n e s . 
Does 
t h i s 
s i t u a t i o n sound f a m i l i a r ? O f c o u r s e - i t ' s e x a c t l y t h e 
s i t u a t i o n 
we have i n t h e C-64 when we plug i n a c a r t r i d g e , s i n c e we 
could 
have E P R O M , 
ROM and RAM p o t e n t i a l l y r e s i d i n g a t t h e same a d d r e s s ! 
Now we s e e t h a t t h e r e i s r e a l l y a simple p r i n c i p a l underlying t h e 
complexity of memory management. The P L A c h i p , 
i n 
i t s i n f i n i t e 
wisdom, knows which c h i p e n a b l e l i n e t o s w i t c h on, 
depending 
on 
what t y p e of c a r t r i d g e ( i f any) i s plugged 
i n and 
whether 
t h e 
o p e r a t i o n i s a read o r a w r i t e . Remember, 
w r i t e 
o p e r a t i o n s 
a r e 
u s u a l l y d i r e c t e d t o R A M , e x c e p t when w r i t i n g t o t h e 
1/0 
d e v i c e s 
a t $D000-DFFF. 
Read o p e r a t i o n s have t o be s o r t e d o u t and d i r e c t e d 
t o t h e proper c h i p ( E P R O M , 
ROM o r R A M ) . 


T h e P L A has many l i n e s coming i n t o i t ( i n p u t s ) t h a t 
i t uses 
t o 
s e n s e t h e p r e s e n t s t a t e of t h e 
computer. 
I t a l s o 
has 
s e v e r a l 
l i n e s coming o u t of i t ( o u t p u t s ) t h a t a r e 
used 
t o c o n t r o l 
t h e 
memory c h i p s . The P L A monitors i t s i n p u t l i n e s c o n t i n u o u s l y . 
Any 
changes i n t h e i n p u t l i n e s a f f e c t t h e o u t p u t 
l i n e s 
immediately. 
One i n p u t l i n e c a l l e d R / W i s used t o d i s t i n g u i s h between read and 
w r i t e o p e r a t i o n s . Write o p e r a t i o n s 
a r e 
" e a s i l y " 
handled 
s i n c e 
t h e y almost always go 
t o 
R A M , 
s o w e ' l l 
c o n c e n t r a t e on 
read 
o p e r a t i o n s . O f a l l t h e PLA's l i n e s , we only need t o be 
concerned 
about f o u r r i g h t now: two i n p u t l i n e s , GAME and 
E X R O M ; 
and 
two 
output l i n e s , ROML and R O M H . The f u n c t i o n of t h e GAME 
and 
E X R O M 
l i n e s i s a f f e c t e d by o t h e r i n p u t l i n e s , such a s HIRAM and 
L O R A M , 


b u t f o r t h i s d i s c u s s i o n w e ' l l assume t h a t 
HIRAM 
and 
LORAM 
a r e 
both held i n t h e i r normal s t a t e ( h i g h ) . 


GAME and E X R O M a r e i n p u t s t o t h e P L A 
from 
t h e 
c a r t r i d g e 
p o r t . 
They a r e n o t connected t o anything e l s e i n t h e C-64. 
GAME i s pin 


#8 on t h e c a r t r i d g e p o r t . On a c a r t r i d g e B O A R D , t h i s i s t h e 
8 t h 
pin from t h e l e f t on t h e t o p s i d e of 
t h e 
board 
( t h e component 
s i d e , where t h e EPROMs a r e mounted). See t h e diagram i n appendix 
D . 
E X R O M i s pin #9, r i g h t next t o G A M E . Both a r e a c t i v e low, t h a t 
i s , when grounded ( 0 v o l t s ) . W i t h no c a r t r i d g e plugged i n , 
t h e s e 
l i n e s a r e a u t o m a t i c a l l y held high (+5 v o l t s ) . 
I t ' s 
up 
t o t h e 
c a r t r i d g e t o ground t h e s e l i n e s o r n o t , according t o t h e memory 
c o n f i g u r a t i o n i t wants t h e P L A t o s e t up. In a n u t s h e l l , t h i s 
i s 
how t h e P L A knows what t y p e of c a r t r i d g e i s connected. 
I f 
E X R O M 
a l o n e i s grounded, i t i n d i c a t e s an 8K 
c a r t r i d g e 
( r e g a r d l e s s of 
how many EPROMs a r e a c t u a l l y on t h e board, a s w e ' l l s e e ) . I f both 
E X R O M and GAME 
a r e 
grounded, 
i t i n d i c a t e s 
a 
16K 
c a r t r i d g e . 
F i n a l l y , i f j u s t t h e G A M E l i n e i s grounded, i t i n d i c a t e s 
a 
M A X 
c a r t r i d g e ( e i t h e r 8K o r 16K). Grounding a l i n e i s a s simple a s i t 
sounds - j u s t connect i t t o t h e computer's ground. P i n s 1 , 22, 
A 
and Z on t h e c a r t r i d g e p o r t a r e a l l grounds. 
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Okay, so GAME and E X R O M t e l l t h e P L A w h a t ' s going on. 
What 
does 
t h e P L A do about i t ? This brings us t o t h e P L A output l i n e s 
R O M L 
( R O M Low) and R O M H ( R O M High). R O M L and R O M H a r e 
connected 
only 
t o t h e c a r t r i d g e p o r t . They a r e both 
normally 
held 
high 
(+5v) 


unless a c a r t r i d g e grounds E X R O M o r GAME ( o r b o t h ) . Depending 
on 
which of t h e s e l i n e s a r e grounded, t h e P L A w i l l bring R O M L and/or 
ROMH low too. What a r e R O M H and ROML? Nothing more than two E P R O M 
enable l i n e s ! R O M L i s t h e combined 
O E / C E 
enable 
l i n e f o r 
t h e 
f i r s t c a r t r i d g e E P R O M , l o c a t e d a t $8000-9FFF i n memory. 
With 
a 
c a r t r i d g e (any t y p e ) plugged i n , t h e P L A w i l l bring ROML low 
any 
time a read 
operation 
t r i e s t o access 
t h e 
$8000-9FFF 
area. 
Remember, bringing an enable l i n e low 
w i l l 
a c t i v a t e t h e 
chip. 
ROML i s not held low all t h e time, s i n c e then t h e c h i p would 
be 
a c t i v e even when 
o t h e r 
a r e a s 
of 
memory 
were 
being 
accessed 
( r e s u l t i n g i n bus c o n f l i c t ) . R O M L i s only 
held 
low 
momentarily 
u n t i l t h e read o p e r a t i o n can be performed. T h i s i s how 
t h e 
P L A 
' t e l l s 1 t h e E P R O M i t i s l o c a t e d a t $8000 - t h e P L A 
only 
enables 
t h e E P R O M when t h a t a r e a of memory i s being accessed. 


The ROMH enable l i n e i s j u s t a l i t t l e more 
complicated 
because 
t h e second E P R O M appears a t d i f f e r e n t l o c a t i o n s 
i n 
memory 
with 
d i f f e r e n t t y p e s of 
c a r t r i d g e s . 
W i t h 
a 
standard 
8K 
c a r t r i d g e 
( E X R O M grounded), t h e second 
E P R O M 
i s not 
used 
and 
so 
i t ' s 
d i s a b l e d by holding R O M H high a t a l l times. With a 
standard 
16K 
c a r t r i d g e (both GAME and E X R O M grounded), any read o p e r a t i o n s 
i n 
t h e SA000-BFFF a r e a w i l l s i g n a l t h e P L A t o bring R O M H low. 
Since 
ROMH i s connected t o t h e second EPROM's enable l i n e s , 
t h i s w i l l 
make t h e EPROM appear a t $A000 i n memory. W i t h 
a 
MAX 
c a r t r i d g e 
( G A M E g r o u n d e d ) , . r e a d o p e r a t i o n s 
i n t h e 
SE000-FFFF area 
w i l l 
enable t h e second E P R O M through ROMH and make i t appear a t $E000. 
Note t h a t with a 
M A X 
c a r t r i d g e , 
you 
MUST 
have 
an 
E P R O M 
a t 


$E000-FFFF s i n c e t h e microprocessor a u t o m a t i c a l l y looks t h e r e 
on 
r e s e t . The $8000-9FFF E P R O M i s optional with MAX c a r t r i d g e s 
(and 
i n f a c t , r a r e l y i f ever used). 


A t t h i s point a l i t t l e review i s i n o r d e r . 
The 
GAME 
and 
E X R O M 
l i n e s r u n from t h e c a r t r i d g e t o t h e P L A . They t e l l t h e 
P L A 
what 
type of memory c o n f i g u r a t i o n t o 
s e t 
u p . 
Based 
on 
t h e 
memory 
c o n f i g u r a t i o n , t h e P L A enables t h e c a r t r i d g e EPROMs a t t h e proper 
times using R O M L and R O M H . C a r t r i d g e EPROMs a r e only enabled 
f o r 
read o p e r a t i o n s , never w r i t e o p e r a t i o n s . 
A 
c a r t r i d g e 
E P R O M 
i s 
only enabled when i t s p a r t i c u l a r a r e a of 
memory 
i s referenced. 
The P L A 
c o n t r o l s which 
area 
of 
memory 
i s assigned 
t o t h e 
c a r t r i d g e EPROMs, depending on t h e s t a t e of t h e 
GAME 
and 
E X R O M 
l i n e s . The P L A monitors t h e GAME and E X R O M l i n e s continuously. 


The c a r t r i d g e t y p e s we've examined so f a r by no means exhaust t h e 
p o s s i b i l i t i e s . By manipulating t h e G A M E , 
E X R O M and 
o t h e r 
l i n e s , 
many e x o t i c c a r t r i d g e s can be c r e a t e d . The most common example of 
an e x o t i c c a r t r i d g e i s a bank-switch c a r t r i d g e . 
"Bank-switching" 
means t u r n i n g memory c h i p s on and o f f , 
so 
d i f f e r e n t 
c h i p s 
can 
occupy t h e same addresses a t d i f f e r e n t times. Sound f a m i l i a r ? The 
C-64 already uses 
bank-switching, 
c o n t r o l l e d 
by 
t h e 
P L A , 
t o 
s e l e c t i t s d i f f e r e n t 
memory 
c o n f i g u r a t i o n s . 
What's 
d i f f e r e n t 
about bank-switched c a r t r i d g e s i s t h a t t h e bank-switching i s done 
on-board 
t h e 
c a r t r i d g e 
i t s e l f , 
i n 
a d d i t i o n 
t o t h e 
memory 
s e l e c t i o n done by t h e P L A . 
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A bank-switched c a r t r i d g e l o o k s l i k e a s t a n d a r d 8K 
c a r t r i d g e 
t o 
the C-64. The c a r t r i d g e w i l l ground o n l y t h e E X R O M l i n e , 
s o 
t h e 
P L A t h i n k s t h e c a r t r i d g e c o n t a i n s 8K 
of 
memory 
a t 
$8000-9FFF. 


This i s a c c u r a t e a s f a r a s i t goes: o n l y 8K of 
c a r t r i d g e 
memory 
w i l l be a v a i l a b l e a t 
a 
t i m e , 
and 
i t w i l l 
appear 
a t 
$8000. 
However, t h e c a r t r i d g e board may c o n t a i n any 
number 
of 
EPROMs. 
Special c i r c u i t r y on-board t h e c a r t r i d g e p i c k s o u t one E P R O M a t a 
time t o appear a t $8000. Accessing t h i s 
memory 
i s a 
two-stage 
p r o c e s s : t h e PLA b r i n g s t h e R O M L e n a b l e l i n e 
low 
and 
t h e n 
t h e 
c a r t r i d g e bank-switch c i r c u i t r y p a s s e s t h i s e n a b l e s i g n a l t o 
i t s 
c u r r e n t l y s e l e c t e d E P R O M . The C-64 d o e s n ' t know about t h e 
second 
s t a g e , of c o u r s e ; i t just s e e s a s t a n d a r d 8K c a r t r i d g e . The 
o n l y 
time the C-64 has t o do a n y t h i n g s p e c i a l i s w h e n 
i t wants 
the 
board t o change t h e c u r r e n t E P R O M . 


To t e l l t h e board t o change t h e c u r r e n t E P R O M , we have t o send 
a 
s p e c i a l s i g n a l t o t h e board. We 
c a n ' t use 
t h e 
r e g u l a r 
a d d r e s s , 
d a t a o r e n a b l e l i n e s f o r t h i s , however. I n s t e a d , most bank-switch 
c a r t r i d g e s use a s p e c i a l l i n e , not 
normally 
used 
f o r 
a n y t h i n g 
e l s e on t h e C-64 ( e x c e p t 
t h e 
280 
C P / M 
c a r t r i d g e ) . 
There 
a r e 
a c t u a l l y two of t h e s e l i n e s t o choose from, c a l l e d 1/01 and 1/02. 
1/01 i s s e t low whenever a r e a d O R w r i t e o p e r a t i o n 
a c c e s s e s 
t h e 


$DEOO-DEFF a r e a ( n o t e t h a t t h e R O M L and R O M H l i n e s 
a r e s e t 
low 
o n l y on r e a d o p e r a t i o n s ) . 1/02 i s s i m i l i a r e x c e p t i t ' s t r i g g e r e d 
by r e f e r e n c e s t o t h e $DFOO-DFFF a r e a . 1/01 and 1/02 
a r e 
p i n s 
7 
and 10 on t h e c a r t r i d g e 
p o r t , 
r e s p e c t i v e l y . 
O n 
a 
bank-switch 
board, one of t h e s e l i n e s w i l l be connected t o a s p e c i a l p i e c e of 
c i r c u i t r y c a l l e d t h e bank-select 
register 
(BSR). Depending 
on 
whether 1/01 o r 1/02 i s used, t h e BSR w i l l 
appear 
a t 
$DEOO 
o r 


$DFOO i n memory. To s w i t c h t h e c u r r e n t E P R O M a l l you have 
t o do 
i s t r i g g e r t h e BSR, u s u a l l y by w r i t i n g a p a r t i c u l a r v a l u e t o i t . 
T h a t ' s a l l t h e r e i s t o i t . Once you t r i g g e r t h e 
BSR, 
t h e 
E P R O M 
s e l e c t e d w i 11 appear a t $8000 immedi a t e l y . 


Bank-switch c a r t r i d g e s a r e e s p e c i a l l y u s e f u l f o r 
programs 
which 
a r e t o o l a r g e t o f i t i n 
16K 
( t h e maximum 
f o r 
a 
r e g u l a r - t y p e 
c a r t r i d g e ) . 
Bank-switching 
can 
a l s o 
p r o v i d e 
c o n s i d e r a b l e 
p r o t e c t i o n f o r a program, depending on how i t i s used. There 
a r e 
two main ways a c a r t r i d g e can use 
bank-switching. 
The 
s i m p l e s t 
way i s t o just download t h e program 
from 
t h e 
EPROMs 
i n t o 
RAM 
memory, 
one 
8K 
chunk 
a t 
a 
time. 
A f t e r 
downloading, 
many 
c a r t r i d g e s can remove t h e m s e l v e s from memory by "ungrounding" t h e 
E X R O M l i n e v i a s p e c i a l c i r c u i t r y . T h i s f r e e s up t h e RAM a t 
$8000 
(under t h e c a r t r i d g e ) f o r use by t h e program. The s i m p l e download 
method i s r e l a t i v e l y e a s y 
t o 
s e t 
up 
b u t 
d o e s n ' t 
o f f e r 
much 
p r o t e c t i o n f o r t h e program. A second way t o u s e bank-switching i s 
t o have d i f f e r e n t s e c t i o n s of t h e program 
on 
d i f f e r e n t 
EPROMs. 
Depending on which p a r t of t h e code 
i s 
needed, 
t h e 
board 
can 
s e l e c t t h e p r o p e r E P R O M . The code i s never downloaded 
i n t o 
R A M , 
b u t r a t h e r executed d i r e c t l y on t h e 
EPROM. 
T h i s 
i s much 
more 
complicated f o r t h e programmer t o s e t up, but i t i s a l s o 
a 
very 
s o l i d program p r o t e c t i o n t e c h n i q u e . To make a RAM e x e c u t a b l e copy 
from such a c a r t r i d g e , i f i t could be done a t a l l , t h e code would 
have t o be modified e x t e n s i v e l y . 
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More and more commercial c a r t r i d g e s now use 
bank-switching. 
For 
example, MAGIC DESK 
( t m ) from Commodore c o n t a i n s f o u r 8K 
EPROMs 


t h a t a r e simply downloaded i n t o RAM ( s e e t h e Dec. 1984 
i s s u e 
of 
t h e PROGRAM PROTECTION NEWSLETTER). The c a r t r i d g e i s s t i l l c a l l e d 
upon t o supply s p r i t e d a t a 
from 
t i m e 
t o time, 
s o 
a 
l i t t l e 
m o d i f i c a t i o n i s r e q u i r e d t o make 
a 
t o t a l l y 
RAM-based 
v e r s i o n . 
Another example of a 
commerci a1 
bank-swi t c h 
c a r t r i d g e 
i s t h e 
COMAL 2.0 
c a r t r i d g e 
( C O M A L 
i s a 
programming 
l a n g u a g e ) . 
The 
c a r t r i d g e c o n t a i n s 64K of program code on E P R O M , 
p l u s 
an 
empty 
E P R O M s o c k e t f o r up t o 32K of y o u r own COMAL programs! Obviously, 
t h e r e i s no way t o f i t a l l 96K of t h i s i n t o RAM a t one time. 


One f i n a l example i s t h e FASTLOAD ( t m ) c a r t r i d g e from E P Y X , which 
uses bank-switching i n a 
novel 
way. 
I t s b a n k - s e l e c t 
r e g i s t e r 


(BSR) i s l o c a t e d i n t h e $DEOO-DEFF a r e a , through t h e 
1/01 
l i n e . 
The BSR g i v e s t h e c a r t r i d g e t h e a b i l i t y t o 
appear 
a t d i f f e r e n t 
l o c a t i o n s i n memory o r d i s a p p e a r from memory e n t i r e l y . Amazingly, 
p a r t of t h e EPROM can a c t u a l l y be r e a d a t $DFOO-DFFF! T h i s b i t of 
magic i s done by using t h e 1/02 l i n e t o e n a b l e 
t h e 
same 
E P R O M 
t h a t normally r e s i d e s a t $8000. 
When 
1/02 
i s brought 
low 
by 
reading from t h e $DFOO-DFFF a r e a , t h e E P R O M w i l l be enabled. This 
makes i t appear i n t h a t a r e a . Only p a r t of t h e E P R O M w i l l be seen 
t h e r e - j u s t t h e code normally found a t $9F00-9FFF. T h i s 
s e c t i o n 
of code c o n t a i n s a whole s e t of r o u t i n e s which a r e patched 
i n t o 
t h e K E R N A L . 


I f you want t o g e t 
i n t o 
bank-switch 
c a r t r i d g e s y o u r s e l f , 
CSM 
c a r r i e s a couple of models. The PC4 model has f o u r s o c k e t s , 
each 
of which can hold a 2764 (8K), 27128 (16K) o r 27256 (32K) 
EPROM. 
D i f f e r e n t E P R O M t y p e s can be used t o g e t h e r on t h e same board. 
By 
using f o u r 27256's, you can g e t 128K on a board t h e same s i z e 
a s 
a s t a n d a r d c a r t r i d g e ! The c a r t r i d g e memory 
i s accessed 
i n 8K 
s e c t i o n s . By changing a few 
b i t s 
of 
t h e 
b a n k - s e l e c t 
r e g i s t e r 
(BSR), you determine which 8K s e c t i o n w i l l appear a t 
$8000. 
The 
BSR can be l o c a t e d a t $DEOO o r $DFOO a s d e s i r e d . The 
board 
a l s o 
has t h e a b i l i t y t o remove i t s e l f from memory completely. The 
PC4 
comes 
w i t h 
s o f t w a r e 
t o download 
t h e 
whole 
board 
t o 
R A M , 
a u t o m a t i c a l l y checking E P R O M t y p e s a s i t goes. CSM a l s o c a r r i e s a 
PC8 board w i t h 8 s o c k e t s , which a l l o w s u p t o 256K on 
t h e 
board! 
All of t h e o t h e r f e a t u r e s of t h e PC4 a r e i n c l u d e d . These a r e t h e 
boards t o use i f you want t o put 
l a r g e 
programs 
on 
E P R O M 
f o r 
personal o r commercial use. L a t e r on i n t h e book w e ' l l p r e s e n t an 
E P R O M programming p r o j e c t using t h e PC4 board. 


We'll c l o s e t h i s c h a p t e r w i t h a s u b j e c t 
r e l a t e d 
t o c a r t r i d g e s , 
namely c a r t r i d g e expansion boards. 
These 
a r e 
p e r i p h e r a l s 
t h a t 
plug i n t o t h e c a r t r i d g e p o r t and have a s l o t o r s l o t s f o r you 
t o 
mount c a r t r i d g e s i n . Expansion boards l e t you i n s e r t 
and 
remove 
c a r t r i d g e s without t u r n i n g t h e computer o f f . T h i s s a v e s wear 
and 
t e a r on y o u r computer and i t s c a r t r i d g e p o r t . 
M u l t i - s l o t 
boards 
allow you t o s e l e c t from s e v e r a l c a r t r i d g e s w i t h 
a 
f l i c k 
of 
a 
switch o r two. Expansion boards a r e not o n l y convenient, b u t t h e y 
a l s o l e t you do t h i n g s you c o u l d n ' t do without one. They can even 
be 
u s e f u l 
f o r 
i n v e s t i g a t i n g 
programs 
which 
aren ' t 
c a r t r i d g e - b a s e d . 
I f 
you 
work 
with 
c a r t r i d g e s much, 
a 
good 
expansion board i s a b s o l u t e l y e s s e n t i a1 . 
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Beware! - a l l e x p a n s i o n b o a r d s a r e n o t c r e a t e d e q u a l . Most 
t y p e s 
o f e x p a n s i o n b o a r d s o n l y l e t y o u t u r n t h e c a r t r i d g e on 
and 
o f f . 
There a r e t w o p a r t i c u l a r 
t y p e s 
o f 
e x p a n s i o n 
b o a r d s 
t h a t 
a r e 
s i g n i f i c a n t l y b e t t e r t h a n most. 
CARDCO's 
F i v e 
S l o t 
Board 
and 


CSM's S i n g l e S l o t B o a r d g i v e y o u c o n t r o l o v e r 
s e v e r a l 
i m p o r t a n t 
c a r t r i d g e 
l i n e s . 
B o t h 
o f 
t h e s e 
e x p a n s i o n 
b o a r d s 
l e t 
y o u 
i n d i v i d u a l l y c o n t r o l t h e EXROM, 
GAME, 
e n a b l e 
and 
power 
l i n e s . 
T h i s c a p a b i l i t y i s v e r y u s e f u l . F o r i n s t a n c e , many 
n o n - c a r t r i d g e 
programs u s e t h e c a r t r i d g e a u t o s t a r t f e a t u r e b y p u t t i n g a "CBM80" 
i n RAM a t $8004. 
I f y o u 
r e s e t 
t h e 
computer, 
t h i s 
a u t o s t a r t 
f e a t u r e w i l l t a k e c o n t r o l and 
p r e v e n t 
y o u 
f r o m 
e x a m i n i n g 
t h e 
program. You can d e f e a t t h i s i f y o u r e x p a n s i o n b o a r d has an E X R O M 
s w i t c h . By g r o u n d i n g 
EXROM, 
t h e 
PLA 
w i l l 
t h i n k 
t h e r e 
i s a 
c a r t r i d g e a t $8000, and i t w o n ' t 
l e t 
t h e 
computer 
" s e e " 
t h e 
a u t o s t a r t code i n RAM. 
T h i s happens even i f t h e r e i s no c a r t r i d g e 
p l u g g e d i n , as l o n g as E X R O M i s grounded. 


B o t h o f t h e e x p a n s i o n b o a r d s m e n t i o n e d above have a - r e s e t 
b u t t o n 
b u i l t - i n . They a l s o have LEDs ( l i g h t s ) on t h e b o a r d t o t e l l 
what 
t y p e o f c a r t r i d g e y o u have i n s e r t e d . I f t h e r i g h t m o s t LED i s l i t , 
i t i n d i c a t e s t h a t t h e c a r t r i d g e 
g r o u n d s 
t h e 
E X R O M 
l i n e . 
T h i s 
means i t ' s a s t a n d a r d 8K c a r t r i d g e ( o r b a n k - s w i t c h t y p e ) . I f b o t h 
l i g h t s a r e lit, b o t h E X R O M and GAME 
a r e 
b e i n g 
grounded, 
w h i c h 
i n d i c a t e s a s t a n d a r d 16K c a r t r i d g e . F i n a l l y , i f j u s t t h e l e f t LED 
i s lit, t h e n 
o n l y 
GAME 
i s grounded, 
w h i c h 
i n d i c a t e s 
a 
MAX 
c a r t r i d g e ( e i t h e r 8K o r 16K). N o t o n l y do t h e s e 
LEDs 
h e l p 
when 
i n v e s t i g a t i n g a c o m m e r c i a l c a r t r i d g e , t h e y 
a l s o 
h e l p 
y o u 
make 
s u r e 
y o u 
have 
s e t 
GAME 
and 
E X R O M 
c o r r e c t l y 
on 
y o u r 
own 
c a r t r i d g e s . 
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AUTOSTART CARTRIDGES 


Suppose you w i s h t o s e t up a c a r t r i d g e 
t h a t 
r u n s 
a u t o m a t i c a l l y 
when t h e computer i s powered up o r RESET. To do t h i s y o u ' l l 
have 
t o i n t e r r u p t t h e normal power-up 
(RESET) 
p r o c e s s 
somehow, 
and 
f o r c e t h e computer t o e x e c u t e y o u r c a r t r i d g e 
program. 
Depending 
on where you i n t e r r u p t t h e normal process, however, y o u r 
program 
may have t o i n i t i a l i z e some areas 
o f 
t h e 
computer 
f o r 
p r o p e r 
o p e r a t i o n . F o r i n s t a n c e , i t may have t o i n i t i a l i z e t h e 6510, 
V I C 
o r C I A c h i p s , o r 
t h e 
KERNAL 
o r 
B A S I C 
RAM 
areas. 
Thus 
i t ' s 
i m p o r t a n t t o know what i n i t i a l i z a t i o n i s done n o r m a l l y , when i t ' s 
done and why. 
I n t h i s c h a p t e r w e ' l l examine t h e v a r i o u s 
ways 
t o 
i n t e r r u p t t h e RESET p r o c e s s and a u t o s t a r t a c a r t r i d g e , 
i n c l u d i n g 
t h e necessary i n i t i a l i z a t i o n t a s k s . 


There 
a r e 
t h r e e 
main 
methods 
you 
can 
use 
t o 
a u t o s t a r t 
a 
c a r t r i d g e . Each method i n v o l v e s i n t e r r u p t i n g t h e RESET p r o c e s s a t 
a d i f f e r e n t p o i n t , and each method i s b e s t s u i t e d t o a 
d i f f e r e n t 
k i n d of c a r t r i d g e . W e ' l l s t a r t w i t h 
t h e 
e a s i e s t 
method 
f i r s t , 
which we c a l l t h e $A000 method ( y o u ' l l see why i n a m i n u t e ) . 
The 
RESET 
p r o c e s s 
can 
be 
d i v i d e d 
i n t o 
two 
phases, 
KERNAL 
i n i t i a l i z a t i o n and B A S I C i n i t i a l i z a t i o n . B A S I C i n i t i a l i z a t i o n 
i s 
o n l y necessary i f y o u r c a r t r i d g e 
must 
be 
c o m p a t i b l e 
w i t h 
t h e 
BASIC system. F o r example, i f y o u r c a r t r i d g e adds commands t o t h e 
B A S I C language o r uses c e r t a i n B A S I C ROM s u b r o u t i n e s , y o u ' l l need 
t o i n i t i a l i z e B A S I C . 


$A000 METHOD 


I f you d o n ' t need t h e B A S I C system, you can 
" t r i c k " 
t h e 
KERNAL 
RESET p r o c e s s i n t o d o i n g a l l y o u r i n i t i a l i z a t i o n f o r you and t h e n 
a u t o s t a r t i n g 
y o u r 
c a r t r i d g e . 
A f t e r 
c o m p l e t i n g 
i t s 
own 
i n i t i a l i z a t i o n 
t a s k s , 
t h e 
KERNAL 
RESET 
r o u t i n e 
a t t e m p t s 
t o 
" c o l d - s t a r t " 
( i n i t i a l i z e ) B A S I C . It does t h i s by jumping 
t o t h e 
l o c a t i o n s p e c i f i e d by 
t h e 
B A S I C 
COLD-START 
VECTOR. 
L i k e 
a l l 
v e c t o r s , t h e B A S I C c o l d - s t a r t v e c t o r c o n s i s t s o f two 
c o n s e c u t i v e 
b y t e s c o n t a i n i n g a memory 
address. 
The 
address 
i s s t o r e d 
i n 
l o - b y t e / 
h i - b y t e 
o r d e r , 
which 
means 
t h e 
l o w 
o r d e r 
( l e a s t 
s i g n i f i c a n t ) b y t e i s f i r s t and t h e h i g h o r d e r (most 
s i g n i f i c a n t ) 
b y t e i s second. The KERNAL e x p e c t s t h e B A S I C c o l d - s t a r t v e c t o r t o 
be f o u n d i n l o c a t i o n s $A000-01, 
w h i c h i s n o r m a l l y 
a t 
t h e 
v e r y 
b e g i n n i n g o f t h e B A S I C ROM. 
The c o n t e n t s o f t h e s e 
two 
l o c a t i o n s 
i n t h e B A S I C ROM a r e $94 and $E3 r e s p e c t i v e l y , which 
means 
t h e y 
" p o i n t " t o l o c a t i o n $E394 ( v e c t o r s 
a r e 
a l s o 
c a l l e d 
p o i n t e r s ) . 
T h i s l o c a t i o n i s t h e s t a r t o f t h e B A S I C c o l d - s t a r t r o u t i n e . 
If we c o u l d change t h e B A S I C c o l d - s t a r t v e c t o r , we c o u l d make 
i t 
p o i n t t o o u r c a r t r i d g e program. 
Our 
c a r t r i d g e 
would 
s t a r t 
up 
a u t o m a t i c a l l y a f t e r a1 1 KERNAL i n i t i a l i z a t i o n was 
f i n i s h e d . 
B u t 
s i n c e t h i s v e c t o r i s i n t h e B A S I C 
ROM, 
how 
do 
we 
change 
i t ? 
Answer: r e p l a c e t h e B A S I C ROM. 
Not p h y s i c a l l y , o f course, b u t 
b y 
u s i n g 
a 
s t a n d a r d 
16K 
c a r t r i d g e . 
R e c a l l 
t h a t 
s t a n d a r d 
16K 
c a r t r i d g e s r e s i d e a t $8000-BFFF. 
The PLA s w i t c h e s o u t 
t h e 
B A S I C 


EPROM HANDBOOK 
AUTOSTART CARTRIDGES 
PAGE 51 


ROM and s e l e c t s t h e 16K c a r t r i d g e c o n f i g u r a t i o n 
when 
i t senses 
t h a t b o t h o f t h e GAME and E X R O M l i n e s a r e grounded. Two 8K EPROMS 
a r e r e q u i r e d f o r 16K o f memory on t h e c a r t r i d g e . The f i r s t 
E P R O M 
r e s i d e s a t $8000-9FFF and t h e second EPROM r e s i d e s a t $A000-BFFF. 
A l l you have t o do i s p u t a v e c t o r a t $A000-01 
which 
p o i n t s 
t o 
t h e b e g i n n i n g o f y o u r program, and t h e c a r t r i d g e w i l l be 
s t a r t e d 
a u t o m a t i c a l l y a t t h e end o f KERNAL i n i t i a1 i 
z a t i o n . 


I f y o u o n l y need 8K f o r y o u r c a r t r i d g e , y o u can 
s t i l l 
use 
t h i s 
technique. J u s t use t h e second EPROM ($A000-BFFF) and 
l e a v e 
t h e 
f i r s t EPROM ($8000-9FFF) s o c k e t empty. As l o n g as GAME and 
EXROM 
a r e grounded, t h e PLA w i l l s t i l l choose 
t h e 
16K 
c o n f i g u r a t i o n . 
T h i s means t h e R A M n o r m a l l y a t $8000-9FFF w i l l s t i l l be 
s w i t c h e d 
out, however (and t h e B A S I C ROM t o o , of c o u r s e ) . S i n c e y o u ' r e n o t 
u s i n g t h e f i r s t c a r t r i d g e EPROM, y o u ' l l have a " h o l e " 
i n memory 
f r o m $8000-9FFF. I f you t r y t o r e a d f r o m t h i s area, 
random 
d a t a 
may appear t h e r e . You may even be a b l e t o use t h i s 
phenomena 
as 
p a r t o f a p r o t e c t i o n scheme. As u s u a l , d a t a w r i t t e n t o t h i s 
a r e a 
w i l l be p l a c e d i n t h e u n d e r l y i n g RAM, 
even though you c a n ' t 
r e a d 
i t back o u t . 


So, t o r e v i e w a b i t , t h e $A000 method i s t h e 
e a s i e s t 
a u t o s t a r t 
t e c h n i q u e t o use because a1 1 KERNAL i n i t i a l i z a t i o n 
i s done 
f o r 
you. You d o n ' t have t o w o r r y about B A S I C i n i t i a l i z a t i o n s i n c e you 
c a n ' t use B A S I C anyway 
( t h e 
B A S I C 
ROM 
i s s w i t c h e d 
o u t ) . 
O f 
course, you d o n ' t have access t o t h e B A S I C ROM s u b r o u t i n e s e i t h e r 
( t h e r e ' s a l o t o f u s e f u l s t u f f i n t h e r e ) . T h i s 
makes 
t h e 
$A000 
method most s u i t a b l e f o r cases where you need t h e maximum 16K 
o f 
c a r t r i d g e memory, o r where you o n l y need 8K and d o n ' t need B A S I C . 


CBM80 METHOD 


The second c a r t r i d g e a u t o s t a r t method i s by f a r t h e most 
common. 
It can be used by b o t h 8K 
and 
16K 
c a r t r i d g e s 
t h a t 
r e s i d e 
a t 
$8000. A l t h o u g h t h i s method i s sometimes 
c a l l e d 
t h e 
" c a r t r i d g e 
a u t o s t a r t o p t i o n " , i t can 
be 
used 
e q u a l l y 
w e l l 
by 
RAM-based 
programs, and o f t e n i s . You 
p r o b a b l y 
know i t as 
t h e 
"CBM80" 


method. One o f t h e f i r s t t h i n g s t h e KERNAL RESET r o u t i n e does 
i s 
check l o c a t i o n s $8004-08 f o r t h e s t r i n g of c h a r a c t e r s "CBM8OU. I f 
t h e s e e x a c t c h a r a c t e r s a r e NOT 
f o u n d 
t h e r e , 
t h e 
KERNAL 
RESET 
process c o n t i n u e s n o r m a l l y . 


I f t h e "CBM80" 
I S found, t h e RESET r o u t i n e i s i n t e r r u p t e d and t h e 
p r o c e s s o r i m m e d i a t e l y jumps t o whatever l o c a t i o n i s s p e c i f i e d 
by 
t h e CARTRIDGE COLD-START VECTOR. T h i s v e c t o r i s e x p e c t e d 
t o 
be 
f o u n d a t l o c a t i o n s $8000-01. 
You must p l a c e a 
p o i n t e r 
here, 
i n 
s t a n d a r d l o - b y t e / h i - b y t e o r d e r , d i r e c t i n g t h e p r o c e s s o r t o 
t h e 
b e g i n n i n g o f y o u r 
c a r t r i d g e 
code. 
From 
t h a t 
p o i n t 
on, 
y o u r 
c a r t r i d g e must h a n d l e 
a l l 
t h e 
i n i t i a l i z a t i o n 
i t s e l f 
f o r 
any 
f u n c t i o n s i t w i l l use, such as t h e 1 / 0 d e v i c e s o r KERNAL o r B A S I C 
r o u t i n e s . F o r t u n a t e l y , you s t i l l have t h e 
KERNAL 
i n i t i a l i z a t i o n 
r o u t i n e s a v a i l a b l e f o r use. Unless y o u know e x a c t l y what y o u 
a r e 
doing, y o u r c a r t r i d g e s h o u l d use t h e s e r o u t i n e s t o i n i t i a l i z e t h e 
f u n c t i o n s i t needs. 
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F i g u r e 8-1 p r e s e n t s a " g e n e r i c " c a r t r i d g e i n i t i a l i z a t i o n r o u t i n e . 
T h i s r o u t i n e d u p l i c a t e s most o f 
t h e 
normal 
RESET 
p r o c e s s . 
I n 
f a c t , i t ' s 
t a k e n 
r i g h t 
f r o m 
t h e 
m a i n 
p a r t s 
o f 
t h e 
KERNAL 


($FCEF-FE) and BASIC 
( $ ~ 3 9 4 - 9 F ) RESET 
r o u t i n e s . 
T h i s 
g e n e r i c 
r o u t i n e w i l l be adequate f o r 99% o f a l l c a r t r i d g e s . 


Figure 8-1 : CBbl8O Cartridge Initialization 


8000 
09 80 
C a r t r i d g e c o l d - s t a r t v e c t o r = $8009 
8002 
25 80 


I1 
I1 
I I w a r m " 
" 
" 
" 
= 
8025 
8004 
C3 C2 CD 38 30 
CBM80 - A u t o s t a r t key 


KERNAL RESET R o u t i n e 
8009 
8E 16 D O 
STX $DO16 
T u r n on V I C f o r PAL/NTSC check 
800C 
20 A3 FD 
JSR $FDA3 
I O I N I T - I n i t C I A c h i p s 
800F 
20 50 FD 
JSR $FD50 
RAMTAS - C l e a r / t e s t system RAM 
8012 
20 15 FD 
JSR $FD15 
RESTOR - I n i t KERNAL R A M v e c t o r s 
8015 
20 58 FF 
JSR $FF5B 
CINT 
- I n i t V I C and s c r e e n e d i t o r 
8018 
58 
CLI 
Re-enabl e I R Q i n t e r r u p t s 


BASIC RESET 
R o u t i n e 
8019 
20 53 E4 
JSR $E453 
I n i t BASIC RAM v e c t o r s 
801C 
20 BF E3 
JSR $ E ~ B F Main BASIC R A M i n i t r o u t i n e 
801F 
20 22 E4 
JSR $E422 
Power-up message / NEW command 
8022 
A2 FB 
LDX #$FB 


8024 
9A 
TXS 
Reduce s t a c k p o i n t e r f o r BASIC 


8025 ........ ......... START Y O U R PROGRAM HERE 


The c a r t r i d g e c o l d - s t a r t v e c t o r and a u t o s t a r t 
key 
(CBM80) 
have 
a l r e a d y been d i s c u s s e d . The w a r m - s t a r t v e c t o r a t 
$8002-03 
i s a 
f e a t u r e t h a t a l l o w s you t o r e - e n t e r y o u r 
program 
a f t e r 
a 
f u l l 
i n i t i a l i z a t i o n has a l r e a d y been done. Once a c o l d - s t a r t has 
been 
done, i t u s u a l l y d o e s n ' t need t o be 
done 
a g a i n . 
P r e s s i n g 
t h e 
RESTORE key c a l l s t h e N M I r o u t i n e (NON-MASKABLE INTERRUPT), w h i c h 
w i l l see t h e CBM80 a n d , j u m p t o t h e 
l o c a t i o n 
i n d i c a t e d 
b t t h e 
w a r m - s t a r t v e c t o r . T h i s i s why many programs 
r e s t a r t 
t h e m s e l v e s 
when y o u p r e s s t h e RESTORE key. I n o u r i n i t i a l i z a t i o n r o u t i n e 
we 
have p o i n t e d t h e w a r m - s t a r t v e c t o r t o t h e s t a r t o f y o u r 
program; 
you c o u l d a l s o p o i n t i t t o $8009 t o p e r f o r m a f u l l c o l d - s t a r t 
on 
RESTORE. I f you want t o d i s a b l e t h e RESTORE key 
e n t i r e l y , 
p o i n t 
t h e w a r m - s t a r t v e c t o r t o $FEBC ( r e t u r n f r o m NMI). 


We 
have i n c l u d e d 
t h e 
BASIC 
RESET 
p r o c e s s 
i n t h i s 
c a r t r i d g e 
i n i t i a l i z a t i o n r o u t i n e t o o . 
A c t u a l l y , 
t h e 
normal 
BASIC 
RESET 
r o u t i n e 
dead-ends 
w i t h 
a 
jump 
t o t h e 
BASIC 
d i r e c t 
mode 
i n t e r p r e t e r , a l s o known as " R E A D Y " mode. T h i s p r i n t s t h e " R E A D Y . " 
prompt and t h e n s i t s t h e r e 
w a i t i n g 
f o r 
y o u 
t o t y p e 
a 
BASIC 
command. You w o n ' t u s u a l l y want t o e x i t i n t o READY mode 
a t 
t h i s 
p o i n t s i n c e BASIC w i l l t a k e o v e r and 
y o u r 
c a r t r i d g e 
w i l l 
l o s e 
c o n t r o l . I f you do want t o e x i t t o BASIC now o r l a t e r , you may do 
so w i t h JMP $E386. By t h e way, t h e r o u t i n e c a l l e d a t 
$801F 
(JSR 


$E422) p r i n t s t h e normal power-up s c r e e n and does a NEW 
command. 
I f y o u want t o s k i p t h e 
power-up 
message, 
j u s t 
c a l l 
t h e 
NEW 
command d i r e c t l y u s i n g JSR $A644 i n s t e a d of JSR $E422. 
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To summarize, t h e CBM80 method can be used w i t h e i t h e r 8K o r 
16K 
s t a n d a r d 
c a r t r i d g e s 
( w h i c h 
s t a r t 
a t 
$8000). 
The 
c a r t r i d g e 
i n i t i a l i z a t i o n r o u t i n e above w i l l 
be 
s u f f i c i e n t 
f o r 
t h e 
v a s t 
m a j o r i t y o f c a r t r i d g e s . KERNAL i n i t i a l i z a t i o n 
must 
be 
done 
a t 
l e a s t once ( o n power-up o r RESET). B A S I C 
i n i t i a l i z a t i o n 
can 
be 
s k i p p e d i f y o u ' r e n o t u s i n g B A S I C , and UUST be s k i p p e d i f y o u ' r e 
u s i n g a 16K c a r t r i d g e . Through t h e c a r t r i d g e 
w a r m - s t a r t 
v e c t o r , 
t h e RESTORE key can be s e t up t o r e - e n t e r y o u r program o r i t can 
be d i s a b l e d e n t i r e l y . The CBM80 method i s by f a r t h e most 
common 
c a r t r i d g e a u t o s t a r t method. 


MAX METHOD 


The t h i r d and l a s t a u t o s t a r t 
method 
i s t h e 
MAX 
method. 
T h i s 
r e q u i r e s t h e use o f an ULTIMAX c a r t r i d g e (one t h a t 
grounds 
j u s t 
t h e GAME l i n e ) . The second EPROM i n a MAX 
c a r t r i d g e 
r e s i d e s 
a t 


$E000-FFFF, 
r e p l a c i n g t h e KERNAL ROM ( t h e f i r s t EPROM appears 
a t 


$8000-9FFF i f used). M A X c a r t r i d g e s have many l i m i t a t i o n s and a r e 
r a r e l y used c o m m e r c i a l l y 
e x c e p t 
f o r 
s i m p l e 
v i d e o 
games. 
One 
l i m i t a t i o n of M A X c a r t r i d g e s i s t h a t o n l y 4K 
o f 
t h e 
c o m p u t e r ' s 
R A M i s a v a i l a b l e f o r use, and o n e - q u a r t e r o f t h a t i s r e q u i r e d f o r 
screen memory. A n o t h e r l i m i t a t i o n 
i s t h a t 
t h e 
KERNAL 
ROM 
i s 
s w i t c h e d o f f , w h i c h means you must w r i t e y o u r 
own 
powerup/RESET 


i n i t i a l i z a t i o n r o u t i n e s ( a l t h o u g h you may use t h e KERNAL r o u t i n e s 
as a g u i d e ) . You d o n ' t need t o w o r r y about 
B A S I C 
i n i t i a l i z a t i o n 
s i n c e t h e B A S I C ROM i s 
s w i t c h e d 
o u t 
t o o . 
F o r 
t h e s e 
reasons, 
y o u ' l l p r o b a b l y n e v e r need t o s e t up a 
MAX 
c a r t r i d g e . 
O n l y 
an 
advanced u s e r would want t o c o n s i d e r u s i n g t h i s method. 


MAX c a r t r i d g e s a u t o s t a r t t h r o u g h a hardware f u n c t i o n o f t h e 
6510 
p r o c e s s o r r a t h e r t h a n t h r o u g h a s o f t w a r e r o u t i n e 
i n t h e 
KERNAL 
l i k e t h e o t h e r two methods. 
When 
t h e 
C-64 
i s powered 
up, 
a 
s p e c i a l c i r c u i t RESETS 
t h e 
6510 
m i c r o p r o c e s s o r , 
S I D 
and 
C I A 
c h i p s , j u s t as i f y o u had p e r f o r m e d a h a r d RESET y o u r s e l f ( w i t h a 
RESET b u t t o n ) . Two v e r y i m p o r t a n t e v e n t s t a k e p l a c e 
i m m e d i a t e l y , 
b e f o r e any i n s t r u c t i o n s a r e even executed. F i r s t , t h e 1 / 0 d e v i c e s 


I A s 
r RAM) 
w i t c h e 
i n t o 
m mory 
by 
t h e 
62A4,aSs1DwelF 
as %de F~RPAL 
and E'AII€ 
R O M S (Inormally?. 
Second, t h e 
6510 p r o c e s s o r f e t c h e s i t s RESET vector f r o m l o c a t i o n s 
SFFFC-FD, 


n o r m a l l y i n t h e KERNAL ROM. 
The RESET v e c t o r i s a t w o - b y t e 
v a l u e 
t h a t p o i n t s t o t h e b e g i n n i n g of t h e 
KERNAL 
RESET 
r o u t i n e . 
The 
p r o c e s s o r ALWAYS g e t s i t s RESET v e c t o r f r o m 
l o c a t i o n s 
$FFFC-FD. 


T h i s f e a t u r e i s " h a r d - w i r e d " 
i n t o t h e 
6510 
c h i p 
i t s e l f , 
and 
CANNOT be changed! You must make s u r e t h e p r o c e s s o r f i n d s a v a l i d 
address i n l o c a t i o n s 
$FFFC-FD, 
w h i c h 
i s why 
t h e 
KERNAL 
i s 
n o r m a l l y s w i t c h e d i n f i r s t 
on 
RESET. 
The 
p r o c e s s o r 
does 
an 
i n d i r e c t jump based on 
t h e 
RESET 
v e c t o r 
and 
n o r m a l l y 
b e g i n s 
e x e c u t i n g t h e KERNAL RESET r o u t i n e . 
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The o n l y a l t e r n a t i v e t o e x e c u t i n g t h e KERNAL RESET r o u t i n e i s i f 
a MAX c a r t r i d g e 
i s p r e s e n t . 
I f t h e 
PLA 
senses 
t h a t 
a 
MAX 
c a r t r i d g e i s p l u g g e d i n (GAME l i n e grounded), i t s w i t c h e s i n t h e 
c a r t r i d g e a t $E000-FFFF, 
r e p l a c i n g t h e KERNAL. Then when t h e 6510 
f e t c h e s i t s RESET v e c t o r f r o m $FFFC-FD, i t w i l l g e t i t f r o m 
t h e 
c a r t r i d g e i n s t e a d o f t h e KERNAL. You s i m p l y 
p l a c e 
a 
v e c t o r 
a t 


$FFFC-FD p o i n t i n g t o t h e b e g i n n i n g o f y o u r RESET r o u t i n e , and t h e 
p r o c e s s o r w i l l s t a r t e x e c u t i n g y o u r r o u t i n e 
a u t o m a t i c a l l y . 
T h i s 
i s how t h e 
MAX 
a u t o s t a r t 
method 
works - 
y o u r 
c a r t r i d g e 
i s 
s w i t c h e d i n and g r a b s c o n t r o l r i g h t f r o m t h e s t a r t . 


Now 
i t ' s 
up 
t o y o u r 
c a r t r i d g e 
t o 
p e r f o r m 
a l l 
necessary 
i n i t i a l i z a t i o n . F o r i n s t a n c e , t h e V I C c h i p must be i n i t i a l i z e d i n 
o r d e r t o use t h e screen. L i k e w i s e , o t h e r 1/0 d e v i c e s w i l l have t o 
be i n i t i a l i z e d i f y o u want t o use t h e 
keyboard, 
t h e 
j o y s t i c k s , 
t h e sound c h i p , 
I R Q i n t e r r u p t s , e t c . I n i t i a l i z i n g and c o n t r o l l i n g 
t h e s e d e v i c e s can be q u i t e c o m p l i c a t e d . We 
recommend t h a t y o u use 
t h e c o r r e s p o n d i n g 
KERNAL 
r o u t i n e s 
as 
a 
model 
f o r 
y o u r 
own 
r o u t i n e s . 
I n f a c t , 
many 
MAX 
c a r t r i d g e s 
c o n t a i n 
a l m o s t 
b y t e - f o r - b y t e c o p i e s o f KERNAL r o u t i n e s . W h i l e we c a n ' t c o v e r t h e 
KERNAL r o u t i n e s i n d e p t h i n t h i s 
book, 
we 
can 
summarize 
t h e 
v a r i o u s i n i t i a l i z a t i o n r o u t i n e s used i n t h e normal RESET process. 
T h i s w i l l h e l p g e t you s t a r t e d t o w a r d s an u n d e r s t a n d i n g 
o f 
what 
i n i t i a l i z a t i o n y o u r c a r t r i d g e w i l l r e q u i r e . 


NORMAL RESET PROCESS 


R e c a l l t h a t when t h e 6510 p r o c e s s o r i s RESET, i t b e g i n s e x e c u t i n g 
a t t h e address s p e c i f i e d by t h e RESET v e c t o r a t $FFFC-FD. 
I n t h e 
KERNAL ROM, 
t h e s e l o c a t i o n s c o n t a i n a p o i n t e r t o t h e KERNAL RESET 
r o u t i n e a t $FCE2 ( d e c i m a l 64738). The main 
p a r t 
o f 
t h e 
KERNAL 
RESET r o u t i n e i s shown i n f i g u r e 8-2. 
Note 
t h e 
s i m i l a r i t i e s 
t o 
o u r CBM80 c a r t r i d g e i n i t i a l i z a t i o n r o u t i n e ( f i g . 8-1 1. The KERNAL 
RESET r o u t i n e t a k e s t h r e e i m p o r t a n t s t e p s r i g h t away. F i r s t , 
I R Q 
i n t e r r u p t s a r e d i s a b l e d w i t h a SEI i n s t r u c t i o n , 
so 
t h e 
r o u t i n e 
w o n ' t be i n t e r r u p t e d . Second, t h e s t a c k p o i n t e r i s i n i t i a l i z e d by 
t r a n s f e r r i n g a v a l u e t o i t f r o m 
t h e 
X - r e g i s t e r , 
u s i n g 
a 
TXS 
i n s t r u c t i o n . The s t a c k p o i n t e r i n d i c a t e s t h e n e x t empty 
p o s i t i o n 
on t h e s t a c k , w h i c h grows DOWNWARD i n memory f r o m $O1FF t o 
$0100 


( i . e . 
t h e p o i n t e r decreases as t h e s t a c k i s f i l l e d ) . 
The 
s t a c k 
p o i n t e r c o n t a i n s a random v a l u e on RESET, 
so 
we 
s h o u l d 
p u t 
a 
v a l u e h e r e b e f o r e any s t a c k o p e r a t i o n s t a k e p l a c e 
( i . e . 
a 
PHA, 
PLA, 
PHP, 
PLP, JSR, 
RTS, 
RTI i n s t r u c t i o n o r an N M I , 
I R Q 
o r 
BRK 
i n t e r r u p t ) . The RESET r o u t i n e s e t s 
t h e 
s t a c k 
p o i n t e r 
t o 
$FF, 


which s t a r t s t h e s t a c k o u t a t 
t h e 
v e r y 
t o p 
( a l l o w i n g i t t h e 
maximum space). 


The t h i r d s t e p i s t o c l e a r t h e 
decimal 
mode 
f l a g 
w i t h 
a 
CLD 
i n s t r u c t i o n . T h i s f l a g c o n t r o l s whether 
math 
i n s t r u c t i o n s 
l i k e 
ADC (add) and SBC ( s u b t r a c t ) a r e p e r f o r m e d i n normal "hex" f o r m a t 
( a c t u a l l y b i n a r y ) o r i n BCD f o r m a t (BINARY CODED 
DECIMAL). 
L i k e 
t h e s t a c k p o i n t e r , t h i s f l a g has a random v a l u e on 
power-up, 
so 
i t i s s e t t o 0 t o ensure t h a t math i s done i n hex f o r m a t . I f you 
w r i t e y o u r own i n i t i a l i z a t i o n r o u t i n e f o r 
a 
M A X 
c a r t r i d g e you 
s h o u l d a l s o do t h e s e t h r e e t h i n g s r i g h t away. 
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FCE2 
FCE4 
FCE5 
FCE6 
FCE7 
F C E A 
F C E C 
FCEF 
FCF2 
FCF5 
FCF8 
FCFB 
FCFE 
FCFF 


Figure 8-2: 
KERNAL RESET ROUTINE 


A2 FF 
L D X #$FF 
Stack p o i n t e r value 
78 
SEI 
Disable IRQ i n t e r r u p t s 


9A 
TXS 
I n i t i a l i z e s t a c k pointer 
D8 
C L D 
Clear decimal mode 
20 02 FD 
JSR $FD02 
Check f o r CBM80 key 
DO 03 
B N E $FCEF 
Branch i f not found 
6C 00 80 
JMP ($8000) Jump t o c a r t r i d g e c o l d - s t a r t 
8E 16 D O 
STA $DO16 
T u r n on VIC (As=$05) 


20 A3 FD 
JSR $FDA3 
IOINIT - I n i t CIA chips 
20 50 FD 
JSR $FD50 
RAMTAS - C l e a r / t e s t system RAM 
20 15 FD 
JSR $FD15 
RESTOR - I n i t K E R N A L RAM v e c t o r s 
20 58 FF 
JSR $FF5B 
CINT - I n i t VIC and screen e d i t o r 
58 
CLI 
Re-enable IRQ i n t e r r u p t s 


6c 00 A0 
JMP ($A000) Jump t o BASIC c o l d - s t a r t ($E394) 


After t h e f i r s t t h r e e s t e p s , t h e RESET r o u t i n e c a l l s an important 
subroutine a t $FD02. This r o u t i n e checks l o c a t i o n s 
$8004-08 
f o r 


"CBM80" a u t o s t a r t key. I f t h e s e exact c h a r a c t e r s a r e found t h e r e , 
t h e 
c a r t r i d g e 
c o l d - s t a r t 
vector 
i s fetched 
from 
$8000-01. 
Execution continues a t whatever l o c a t i o n 
i s i n d i c a t e d 
by 
t h i s 
vector. This i s t h e point a t which 
t h e 
CBM80 
a u t o s t a r t 
method 
t a k e s c o n t r o l . 


If t h e r e i s no "CBM80" found, 
t h e 
RESET 
process 
continues 
a t 


$FCEF. The X r e g i s t e r i s s t o r e d i n t o l o c a t i o n $D016, which i s t h e 
VIC control r e g i s t e r . The value of X a t t h i s point i s always 
$05 
o r l e s s , s i n c e i t was used a s an index i n t h e check 
f o r 
"CBM80" 


(which has 5 c h a r a c t e r s ) . Commodore says i t ' s extremely important 
t o make s u r e b i t number 5 of t h i s value i s a 0, which 
i t i s i n 
t h i s case. A 0 i n b i t 5 supposedly t u r n s t h e VIC c h i p on and a 
1 
t u r n s i t off ( s e e p. 322 and p . 448 i n t h e Prog. Ref. Guide). For 
s a f e t y ' s sake your own i n i t i a l i z a t i o n r o u t i n e should s e t t h i s b i t 
t o 0 t o o . There's an i n t e r e s t i n g 
s i d e - e f f e c t 
when 
values 
l e s s 
than $05 a r e s t o r e d i n t h i s r e g i s t e r . In t h o s e c a s e s , b i t 3 w i l l 
a l s o be a 0, which s e l e c t s 38-column mode. T h a t ' s why t h e 
screen 
"shrinks" when t h e computer goes through i t s normal RESET process 
- bet you always wondered about t h a t ! 


Next, t h e f o u r main K E R N A L i n i t i a l i z a t i o n 
r o u t i n e s 
a r e 
c a l l e d . 
These a r e t h e same r o u t i n e s we c a l l e d i n our CBM80 i n i t i a l i z a t i o n 
r o u t i n e . The f i r s t r o u t i n e i s IOINIT, 
located 
a t $FDA3. 
This 
r o u t i n e can a l s o be reached by jumping t o $FF84 i n 
t h e 
standard 
K E R N A L j u m p t a b l e . IOINIT 
i n i t i a l i z e s t h e 
CIA 
chips. 
I t a l s o 
does some o t h e r minor i n i t i a l i z a t i o n 
such 
a s t u r n i n g 
o f f 
t h e 


SID's sound, switching i n t h e BASIC and K E R N A L ROMs (redundant on 
a hard RESET) and sending a high clock s i g n a l ( " 1 " 
b i t ) 
on 
t h e 
s e r i a l bus. Next, t h e K E R N A L r o u t i n e RAMTAS a t $FD50 
i s c a l l e d 


($FF87 i n t h e j u m p t a b l e ) . This r o u t l n e 
c l e a r s 
and 
t e s t s 
RAM. 
F i r s t , t h e r o u t i n e f i 11 s 
1 o c a t i ons 
$0002-01 01, 
$0200-02FF 
and 


$0300-$03FF (pages 0, 2 & 3 ) with $00 bytes. This piece 
of 
code 
i s r e s p o n s i b l e f o r t h e c a s s e t t e b u f f e r , 
e t c . 
being 
c l e a r e d 
on 
RESET. Note t h a t t h e s t a c k i s not c l e a r e d (except t h e bottom 
two 
bytes 1. 
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A f t e r t h i s , RAMTAS s e t s t h e 
c a s s e t t e 
b u f f e r 
p o i n t e r 
and 
t h e n 
b e g i n s t e s t i n g RAM memory s t a r t i n g a t 
$0400 
( t h e 
s c r e e n ) . 
The 
purpose o f t h i s t e s t i s t o f i n d 
t h e 
s t a r t 
o f 
non-RAM 
memory, 
i 
.e., 
t o see if t h e r e i s c a r t r i d g e ROM 
a t 
$8000. 
The 
t e s t 
i s 
supposed t o be 
" n o n - d e s t r u c t i v e " 
i n t h a t 
R A M 
memory 
i s n o t 
a l t e r e d . F i r s t , t h e c u r r e n t c o n t e n t s o f t h e l o c a t i o n t o be t e s t e d 
a r e saved i n t h e X - r e g i s t e r . 
A 
$55 
b y t e 
i s s t o r e d 
i n t o t h e 
l o c a t i o n and t h e n t h e l o c a t i o n i s r e a d back t o see i f t h e $55 was 
s t o r e d s u c c e s s f u l l y . If t h e l o c a t i o n now c o n t a i n s a $55 
t h e n i t 
i s o b v i o u s l y i n R A M - o r i s i t ? What i f t h e l o c a t i o n 
i s i n 
ROM 
b u t happened t o a l r e a d y c o n t a i n a $55? To doublecheck 
t h i s , 
t h e 
p r o c e s s i s r e p e a t e d w i t h t h e v a l u e $AA 
i n s t e a d 
o f 
$55. 
I f i t 
passes b o t h 
t e s t s , 
t h e 
l o c a t i o n 
i s d e f i n i t e l y 
i n RAM. 
The 
o r i g i n a l v a l u e saved i n X i s r e s t o r e d , 
and 
t h e 
t e s t 
c o n t i n u e s 
w i t h t h e n e x t b y t e . 


E v e n t u a l l y , t h e r o u t i n e w i l l r u n i n t o ROM ( e i t h e r 
c a r t r i d g e 
ROM 
a t $8000 o r BASIC R O M a t $A000). When ROM i s encountered, a 
v e r y 
u n d e s i r a b l e s i d e - e f f e c t o c c u r s . The $55 b y t e t h a t i s w r i t t e n 
o u t 
goes i n t o t h e R A M " u n d e r " t h e ROM, w i p i n g o u t t h e v a l u e t h a t 
was 
t h e r e . T h i s i s i m p o r t a n t t o 
remember 
when 
y o u 
a r e 
t r y i n g 
t o 
r e c o v e r a c r a s h e d program by r e s e t t i n g it. Once t h e s t a r t o f 
ROM 
i s found, 
a r o u t i n e a t $FEZ5 (MEMTOP, jump t a b l e $FF99) i s c a l l e d 
t o s e t t h e t o p o f system R A M t o t h e b e g i n n i n g o f ROM. 
The t o p 
o f 
system R A M i s used i n t h e c a l c u l a t i o n 
o f 
t h e 
number 
o f 
BASIC 
b y t e s f r e e . F i n a l l y , t h e b o t t o m o f system R A M i s s e t 
t o $0800, 
and t h e s t a r t o f t h e s c r e e n 
i s s e t 
t o 
$0400 
f o r 
t h e 
s c r e e n 
e d i t o r . 


Back i n t h e main RESET r o u t i n e , a 
r o u t i n e 
a t 
$FD15 
i s c a l l e d 


(RESTOR, jump t a b l e $FF8A). 
T h i s 
r o u t i n e 
c o p i e s 
t h e 
KERNAL's 


i n d i r e c t R A M v e c t o r s t o $0314-33 
f r o m 
t h e 
t a b l e 
a t 
$FD30-4F. 


Oddly enough, i t a l s o c o p i e s t h i s v e c t o r t a b l e i n t o t h e R A M under 
t h e KERNAL a t $FD30-4F t o o ! I f y o u 
a r e 
t r y i n g 
t o 
r e c o v e r 
t h e 
c o n t e n t s o f t h e R A M under t h e KERNAL a f t e r a 
RESET, 
you 
s h o u l d 
remember t h i s f e a t u r e . 


The f i n a l KERNAL i n i t i a l i z a t i o n r o u t i n e i s a t $FF5B 
(CINT, 
jump 
t a b l e $FF81). T h i s r o u t i n e i n i t i a l i z e s t h e V I C 
c h i p 
and 
s c r e e n 
e d i t o r v a r i a b l e s . The 
V I C 
c h i p 
i s i n i t i a l i z e d 
b y 
c a l l i n g 
a 
r o u t i n e a t $E5AO w h i c h downloads a s e t o f c o n s t a n t s 
t o 
t h e 
V I C 
f r o m $ECB9-E6. 
T h i s s e t s t h e b o r d e r and background c o l o r s as w e l l 
as t h e r a s t e r i n t e r r u p t r e g i s t e r , 
used 
i n t h e 
PAL/NTSC 
check 
d i s c u s s e d below. The s c r e e n e d i t o r i s i n i t i a l i z e d b y a r o u t i n e a t 
$E518. T h i s s e t s 
t h e 
c h a r a c t e r 
c o l o r , 
k e y b o a r d 
decode 
t a b l e 
v e c t o r , c u r s o r b l i n k and k e y r e p e a t r a t e s , and 
t h e n 
c l e a r s 
t h e 
screen. The CINT r o u t i n e ends w i t h t h e PAL/NTSC 
check. 
NTSC 
i s 
t h e N o r t h American TV s t a n d a r d and PAL i s t h e 
I n t e r n a t i o n a l 
TV 
s t a n d a r d . There a r e more l i n e s on t h e s c r e e n w i t h PAL. his 
f a c t 
i s used t o d e t e c t w h i c h system you have, so t h e 
I R Q 
and 
RS-232 
t i m i n g can be a d j u s t e d a c c o r d i n g l y . The V I C r a s t e r ( s c r e e n 
l i n e ) 
i n t e r r u p t was s e t e a r l i e r t o o c c u r on a l i n e w h i c h d o e s n ' t 
e x i s t 
w i t h NTSC. L a t e r ( a t $FF63) t h e i n t e r r u p t i s checked t o see i f i t 
happened. I f i t d i d , w e ' r e on a PAL system, o t h e r w i s e i t ' s 
NTSC. 
See t h e Prog. Ref. Guide pp. 150 & 447 f o r 
more 
i n f o r m a t i o n 
on 
t h e r a s t e r i n t e r r u p t r e g i s t e r . 
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T h a t ' s about i t f o r t h e KERNAL RESET r o u t i n e . IRQs were 
d i s a b l e d 
e a r l i e r , so t h e y a r e r e - e n a b l e d w i t h a CLI i n s t r u c t i o n . 
F i n a l l y , 
B A S I C i n i t i a l i z a t i o n i s begun 
b y 
j u m p i n g 
based 
on 
t h e 
B A S I C 
c o l d - s t a r t v e c t o r i n t h e B A S I C ROM a t $A000-01. I f a 16K s t a n d a r d 
c a r t r i d g e 
i s p r e s e n t , 
however, 
i t s second 
E P R O M 
w i l l 
have 
r e p l a c e d t h e B A S I C ROM i n memory. I n t h i s 
case 
we 
must 
p u t 
a 
v e c t o r a t $A000 ( i n t h e second c a r t r i d g e EPROM) t o p o i n t 
t o 
t h e 
s t a r t o f t h e c a r t r i d g e program. T h i s i s t h e b a s i s f o r 
t h e 
$A000 
a u t o s t a r t method. N o t i c e how a l l t h e 
KERNAL 
i n i t i a l i z a t i o n has 
a l r e a d y been done f o r us i n t h i s case. 


F o r you MAX c a r t r i d g e u s e r s , t h i s b r i e f o u t l i n e s h o u l d be a g u i d e 
t o examining t h e RESET p r o c e s s y o u r s e l f . 
A r e f e r e n c e book such as 
ANATOMY OF THE COMMODORE 64 w i 11 be an i n v a l u a b l e a i d . 
There 
i s 
no s u b s t i t u t e f o r s t u d y i n g t h e RESET 
p r o c e s s 
y o u r s e l f . 
We 
can 
o n l y g i v e you a few g u i d e l i n e s about what y o u s h o u l d 
and 
s h o u l d 
n o t do i n y o u r MAX c a r t r i d g e . The o n l y t h i n g s you H A V E t o do 
a r e 
s e t t h e s t a c k p o i n t e r t o some 
v a l u e 
( u s u a l l y 
$FF) 
and 
e i t h e r 
c l e a r 
o r 
s e t 
decimal 
mode 
( u s u a l l y 
c l e a r ) . 
Y o u ' l l 
a l m o s t 
c e r t a i n l y want t o use t h e screen, so y o u ' l l need t o 
s e t 
up 
t h e 
V I C c h i p . Look a t t h e t a b l e o f c o n s t a n t s a t 
$ECB9 
t o 
see 
what 
v a l u e s a r e p u t i n t o t h e V I C ' s r e g i s t e r s n o r m a l l y . 
A l s o 
remember 
t o t u r n t h e V I C on as done a t $FCEF-F1, 
and 
s e l e c t 
i t s memory 
bank as done a t $FDCB-CF. I f you want t o do a PAL/NTSC check, t h e 
code a t $FF5E-6A can be y o u r g u i d e . I f you want t o s e t up an 
I R Q 
i n t e r r u p t , s t u d y t h e I O I N I T r o u t i n e and 
t h e 
code 
a t 
$FF6E-7C. 


D i s k , t a p e o r RS232 communications w i l l r e q u i r e enormous 
amounts 
o f code. I f you 
t h i n k 
you 
need 
any 
o f 
these, 
you 
p r o b a b l y 
s h o u l d n ' t be u s i n g a MAX c a r t r i d g e anyway. 


We can a l s o p o i n t some i n i t i a l i z a t i o n r o u t i n e s 
you 
WON'T 
need. 
The CBM80 check r o u t i n e a t $FD02 i s n o t i m p o r t a n t s i n c e y o u r 
MAX 
c a r t r i d g e has a l r e a d y been a u t o s t a r t e d . You w o n ' t need t h e RAMTAS 
r o u t i n e ($FD50) w h i c h c l e a r s memory and t e s t s f o r t h e end o f 
RAM 


/ s t a r t o f ROM. 
Your program can e a s i l y c l e a r memory i t s e l f , 
and 
t h e end o f R A M t e s t w o u l d always y i e l d t h e same r e s u l t s ( t h e o n l y 
RAM i s a t $0000-OFFF). 
The RESTOR r o u t i n e (FD15) i s used 
t o 
s e t 
up R A M v e c t o r s f o r KERNAL r o u t i n e s w h i c h a r e n ' t a v a i l a b l e anyway, 
so i t can be d i s p e n s e d w i t h . I n s h o r t , o n l y t h e I O I N I T 
and 
CINT 
r o u t i n e s ( a n d r e 1 a t e d r o u t i n e s ) c o n t a i n u s e f u l MAX i n i t i a l i z a t i o n 
code. A l o t o f t h i s code i s s u p e r f l u o u s t o o . The b e s t i d e a i s t o 
p l a n o u t which f u n c t i o n s y o u ' l l 
need 
and 
t h e n 
s t u d y 
how 
t h e 
KERNAL s e t s up j u s t t h o s e f u n c t i o n s . 


To r o u n d o u t t h i s c h a p t e r , we s h o u l d l o o k a t one o t h e r s u b j e c t of 
general 
i n t e r e s t , 
WARM-STARTS 
( v i a t h e 
RESTORE 
k e y ) . 
We've 
a l r e a d y covered t h e 
c a r t r i d g e 
w a r m - s t a r t 
v e c t o r 
a t 
$8002-03, 
which o n l y a p p l i e s t o t h e CBM80 a u t o s t a r t method. 
There 
i s one 
o t h e r w a r m - s t a r t method. I f t h e STOP key i s h e l d down a l o n g 
w i t h 
RESTORE, and t h e r e i s no CBM80, t h e B A S I C w a r m - s t a r t v e c t o r 
w i l l 
be used. T h i s v e c t o r i s l o c a t e d a t $A002-3, 
n o r m a l l y i n t h e B A S I C 
ROM. I f we have a 16K c a r t r i d g e ($A000 
method), 
w h i c h 
r e p l a c e s 
t h e B A S I C ROM, we can p u t o u r own w a r m - s t a r t v e c t o r i n a t 
$A002. 


I n f a c t , you s h o u l d always p u t a 
v a l i d 
v e c t o r 
t h e r e 
t o 
g u a r d 


a g a j n s t 
t h e 
u s e r 
a c c i d e n t a l l y 
p r e s s i n g 
t h e 
RUN/STOP-RESTORE 


combination. 
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F i n a l l y , t h e r e i s no w a r m - s t a r t method f o r MAX c a r t r i d g e s 
u n l e s s 
you program i t y o u r s e l f . You may choose t o use 
t h e 
RESTORE 
k e y 
f o r t h i s o r some o t h e r method. I f y o u d o n ' t use t h e RESTORE 
key, 
you s h o u l d s e t t h e 6510 N M I v e c t o r a t $FFFA-FB t o p o i n t t o an RTI 
i n s t r u c t i o n i n case t h e u s e r a c c i d e n t a l l y 
p r e s s e s 
RESTORE. 
The 
6510 i s h a r d - w i r e d t o use $FFFA-FB as i t s v e c t o r when an 
N M I 
i s 
g e n e r a t e d (RESTORE k e y p r e s s e d ) , j u s t as i t always uses 
$FFFC-FD 


f o r i t s RESET v e c t o r . 


I n o t h e r c h a p t e r s o f t h e book we p r e s e n t some u t i l i t i e s 
y o u 
can 
use t o c r e a t e y o u r own c a r t r i d g e s . R e f e r back t o t h i s c h a p t e r 
i f 
you have q u e s t i o n s a b o u t how t h o s e u t i l i t i e s work o r i f y o u 
want 
t o m o d i f y them. 
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PROTECTING CARTRIDGES 


In one sense, putting 
a program 
on 
c a r t r i d g e 
i s a form 
of 
protection a l l by i t s e l f , a t l e a s t as f a r as the average user 
i s 
concerned. Almost everyone has a good selection of 
u t i l i t i e s t o 
copy disks, b u t there are very few u t i l i t i e s available 
t o copy 
cartridges 
( C A R T R I D G E B A C K E R 
comes 
t o 
m i n d ) . 
Since 
most 
cartridges a u t o s t a r t themselves, there i s no easy opportunity 
t o 
examine the c a r t r i d g e memory. As f a r as 
"professional" 
p i r a t e s 
are concerned, however, ripping off an unprotected 
c a r t r i d g e i s 
l i k e taking candy from a baby. So 
c a r t r i d g e manufacturers 
have 
been forced t o use some type of protection, j u s t as manufacturers 
of disk-based software were. Most commercial cartridges 
are now 
protected in one way or another. 


Cartridge protection methods can be c l a s s i f i e d i n t o two 
general 
categories based on whether the protection scheme requires 
extra 
hardware in the c a r t r i d g e or not. Extra hardware i n the c a r t r i d g e 
can provide very e f f e c t i v e protection b u t i t i s more expensive to 
design and produce. The program has t o be 
designed 
around 
the 
protection scheme i n order f o r t h e protection t o be e f f e c t i v e . I n 
t h i s chapter we'll focus on what can be done using j u s t 
standard 
c a r t r i d g e boards, since these 
techniques 
are the e a s i e s t 
f o r 
average programmers t o apply t o t h e i r c a r t r i d g e s . 


One limitation of using only standard hardware i s t h a t you 
c a n ' t 
protect against t h e p i r a t e who simply duplicates the 
EPROM 
and 
s t i c k s i t i n a standard board. However, making a duplicate 
of 
a 
cartridge t h i s way can cost the p i r a t e almost as much 
money 
as 
t h e original c a r t r i d g e would. What most p i r a t e s r e a l l y want i s a 
copy of the c a r t r i d g e t h a t can be loaded from 
disk 
and 
run 
in 
RAM. Therefore our goal i s t o prevent the program from running in 
RAM ( o r e l s e detect t h e f a c t t h a t i t was loaded from d i s k ) . 


To prevent the program from running in 
R A M , 
we 
must 
use 
some 
method t h a t can distinguish whether t h e program i s running i n RAM 
or R O N ( E P R O M ) . The simplest and most common technique depends on 
the fundamental difference between 
RAM 
and 
ROM: 
RAM 
can 
be 
altered by writing t o i t , b u t ROM cannot. By storing a value i n t o 
the area where the c a r t r i d g e r e s i d e s , a RAM copy of 
t h e program 
can be made t o crash, while a ROM copy will not be affected. This 
i s almost absurdly easy t o p u t i n t o practice, 
as 
the following 
example i l l u s t r a t e s . Assuming t h a t t h e r e i s a statement a t 
$8040 
which i s required f o r proper operation of 
the program, 
a l l 
we 
have t o do i s make sure t h e following piece of code 
i s executed 
sometime before t h e code a t $8040 i s executed: 


L D A #$02 
STA $8040 
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If t h e program i s i n ROM, 
t h i s code w i l l have no e f f e c t 
( o n 
t h e 
ROM, 
a t l e a s t ) . I f t h e program i s i n RAM, 
however, t h e 
s t a t e m e n t 
a t $8040 w i l l be a l t e r e d and t h e 
program 
w i l l 
c r a s h 
when 
t h e 
statement i s executed. The v a l u e $02 was chosen because i t i s n o t 
a s t a n d a r d 6502 opcode; i t i s an undocumented opcode w h i c h causes 
t h e p r o c e s s o r t o l o c k up. Depending on what 
t h e 
code 
a t 
$8040 
a c t u a l l y does, many o t h e r v a l u e s c o u l d p r o b a b l y 
have 
been 
used 
i n s t e a d o f $02. The v a l u e you choose d o e s n ' t even 
have 
t o make 
t h e program h a l t . F o r i n s t a n c e , i n a program t h a t depends h e a v i l y 
on sound, you c o u l d s i m p l y a l t e r one k e y v a l u e t h a t i s p l a c e d 
i n 
t h e sound c h i p . As l o n g as t h e a l t e r e d b y t e d i s r u p t s 
t h e 
normal 
o p e r a t i o n of t h e program enough t o make t h e copy 
unuseable, 
y o u 
have succeeded i n p r o t e c t i n g t h e program. Memory l o c a t i o n s can be 
a l s o changed w i t h STX, 
STY, 
DEC, 
I N C , ASL, 
LSR, ROL o r ROR. 


Many c a r t r i d g e s a r e n ' t any b e t t e r p r o t e c t e d t h a n 
t h i s . 
However, 
e x p e r i e n c e d p i r a t e s can f i n d t h i s code and d e f e a t i t i n a 
m a t t e r 
o f m i n u t e s . H e r e ' s how t h e y do i t . F i r s t , t h e y make a RAM c o p y o f 
t h e c a r t r i d g e and 
r u n i t . When 
i t c r a s h e s , 
t h e y 
RESET 
t h e 
computer and save o u t t h e c r a s h e d copy. B 
comparing t h e 
c r a s h e d 
copy w i t h t h e o r i g i n a l , u s i n g a machrne 
Tanguage 
m o n i t o r , 
t h e y 
can see a t once t h a t t h e o n l y d i f f e r e n c e i s t h e 
b y t e 
a t 
$8040. 
Next t h e y w o u l d u s e t h e h u n t f e a t u r e o f t h e m o n i t o r t o 
f i n d 
a l l 
r e f e r e n c e s t o l o c a t i o n $8040. By l o o k i n g a t 
t h e 
a r e a s 
o f 
code 
l i s t e d , t h e y would q u i c k l y s p o t t h e code y o u used as 
t h e 
s o u r c e 
of t h e p r o t e c t i o n . By c h a n g i n g t h e STA s t a t e m e n t t o a s e t o f NOPs 
( o r s i m p l y a LDA), t h e p r o t e c t i o n would be d e f e a t e d . 


The r e a s o n t h i s p r o t e c t i o n code was 
so 
easy 
t o 
f i n d 
i s t h a t 
l o c a t i o n $8040 was r e f e r r e d t o d i r e c t l y . I f we c o u l d 
" h i d e " 
t h e 
r e f e r e n c e t o l o c a t i o n $8040, we c o u l d make t h e p r o t e c t i o n 
scheme 
much more d i f f i c u l t t o f i n d w i t h a h u n t command. One way t o 
h i d e 
memory r e f e r e n c e s i s t o 
use 
o t h e r 
ADDRESSING 
MODES. 
I n t h e 
example above we used 
what 
i s c a l l e d 
DIRECT 
ADDRESSING: 
t h e 
l o c a t i o n 
i s s p e c i f i e d 
d i r e c t l y 
i n t h e 
STA 
command. 
O t h e r 
a d d r e s s i n g modes t h a t 
we 
c o u l d 
have 
used 
i n s t e a d 
o f 
d i r e c t 
a d d r e s s i n g i n c l u d e INDEXED ADDRESSING, 
INDIRECT 
ADDRESSING 
and 
two c o m b i n a t i o n s o f 
t h e s e 
modes 
c a l l e d 
INDIRECT 
INDEXED 
and 
INDEXED INDIRECT. 


INDEXED a d d r e s s i n g uses t h e X o r Y r e g i s t e r as an o f f s e t ( i n d e x ) . 
The v a l u e o f t h e i n d e x i s added t o t h e a d d r e s s s p e c i f i e d 
i n t h e 
STA s t a t e m e n t . The r e s u l t g i v e s t h e a c t u a l l o c a t i o n t o be 
s t o r e d 
i n t o . F o r example, we c o u l d have 
used 
t h e 
f o l l o w i n g 
p i e c e 
of 
code: 


LDA #$02 
LDY #$40 
STA $8000,Y 


I n t h e STA s t a t e m e n t , t h e v a l u e 
o f 
Y 
( $ 4 0 ) 
i s added 
t o 
t h e 
address $8000 ( c a l l e d t h e base a d d r e s s ) t o c a l c u l a t e 
t h e 
f i n a l 
address t o be used: $8000 + $40 = $8040. So t h i s 
p i e c e 
o f 
code 
w i l l do e x a c t l y what o u r p r e v i o u s example d i d . The v a l u e 
o f 
t h e 
a c c u m u l a t o r ( $ 0 2 ) w i l l be s t o r e d i n l o c a t i o n 
$8040. 
You 
c o u l d 
a l s o have used t h e X r e g i s t e r 
as 
t h e 
i n d e x 
i n s t e a d 
o f 
Y 
t o 
a c c o m p l i s h t h e same t h i n g . 
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In INDIRECT addressing, t h e address i s specified 
i n d i r e c t l y by 
giving a location which contains the 
address, 
rather 
than 
the 
address i t s e l f . For instance, r a t h e r than use the 
address 
$8040 
d i r e c t l y , we could s t o r e the bytes $80 and $40 in two consecutive 
locations, say $9000 and $9001. Actually, we have 
t o 
s t o r e the 
bytes in reverse order - the low byte ($40) i s stored 
in 
$9000 
and the high byte ($80) i s stored in 
$9001. 
Locations 
$9000-01 
would then be called a V E C T O R pointing t o $8040. 
The 
vector 
i s 
NOT the address i t s e l f ; t h e vector i s t h e locations t h a t 
CONTAIN 
the address. 


The only instruction on the 6502/6510 processor 
t h a t 
uses 
pure 
indirect addressing i s the i n d i r e c t JMP i n s t r u c t i o n : 


JMP ($9000) 


Assuming locations $9000-01 are a vector pointing 
t o $8040, 
as 
explained above, t h i s instruction would cause a 
j u m p 
t o $8040. 
The parentheses around $9000 are used t o indicate t h a t 
i t i s a 
vector, not the f i n a l address. 


More 
useful 
than 
pure 
i n d i r e c t 
i s a 
hybrid 
form 
called 
INDIRECT I N D E X E D . 
This 
form 
combines 
i n d i r e c t 
and 
indexed 
addressing. F i r s t an address i s retrieved from 
the vector, 
and 
then the index i s added t o i t t o get the f i n a l address. There are 
two important things t o 
remember 
about 
i n d i r e c t 
indexed. 
The 
vector i t s e l f must be located in zero page ($0000-OOFF), and 
the 
Y-register must be used as the index. Remember, the 
vector 
must 
be located in zero page b u t i t can point t o (contain the 
address 
o f ) A N Y location in memory. 


Let's go back t o our e a r l i e r examples in which we want t o s t o r e a 
$02 
byte 
a t 
$8040. 
This 
time 
we'll 
use 
i n d i r e c t 
indexed 
addressing t o do i t . F i r s t we must 
s e t 
u p 
an 
address 
in 
our 
vector. Since the index will be added t o t h i s address before 
the 
STA takes place, t h e vector does 
not 
have 
t o point 
t o $8040 
i t s e l f . I t can point t o any location 0-255 
bytes 
before 
$8040. 
Let's point the vector t o , say, $8000. Remember t h a t t h i s 
vector 
must be located in zero page. We'll use locations $FB-FC 
as 
the 
vector, so we'll p u t a $00 byte in $FB and an $80 
byte 
in 
$FC. 


Here's what the code looks l i k e : 


L D A #$00 
STA $FB 
L D A #$80 
STA $FC 
L D A #$02 
L D Y #$40 
STA ($FB),Y 


The f i r s t four statements s e t u p the vector a t $FB-FC. The 
f i f t h 
statement ( L D A #$02) gets our crash value ready, and the next one 
i n i t i a l i z e s our 
index 
( L D Y #$40). The 
STA 
statement 
f i r s t 
retrieves the address $8000 from t h e vector a t $FB-FC, then 
adds 
the index value $40 t o i t : 
$8000 + 40 = $8040. 
This 
gives 
the 
final address, where the accumulator value ($02) will be stored. 
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Our n e x t a d d r e s s i n g mode i s c a l l e d i n d e x e d 
i n d i r e c t . 
Both 
t h i s 
mode and t h e mode i n t h e l a s t example use i n d i r e c t and 
i n d e x i n g , 
b u t i n a d i f f e r e n t o r d e r . I f y o u have t r o u b l e k e e p i n g t h e i r names 
a p a r t , j o i n t h e crowd. J u s t remember t h a t t h e name t e l l s i n what 
o r d e r t h e two modes w i 11 be 
used. 
I n d i r e c t 
i n d e x e d 
( o u r 
1 a s t 
example) FIRST r e t r i e v e s an address f r o m 
t h e 
i n d i r e c t 
1 o c a t i on 
g i v e n i n t h e s t a t e m e n t , and THEN adds t h e i n d e x 
t o 
t h e 
address 
r e t r i e v e d t o g e t t h e f i n a l address. Indexed 
i n d i r e c t 
( o u r 
n e x t 
example) FIRST adds 
t h e 
i n d e x 
t o 
t h e 
address 
g i v e n 
i n t h e 
statement, and THEN uses t h e 
r e s u l t 
as 
t h e 
i n d i r e c t 
l o c a t i o n 
( v e c t o r ) t o r e t r i e v e t h e f i n a l address from. 
I n t h i s 
new 
mode, 
t h e address g i v e n i n t h e s t a t e m e n t i s n o t t h e f i n a l 
address 
and 
i t i s n ' t even t h e l o c a t i o n o f t h e v e c t o r . I t i s a 
base 
address 
which t h e i n d e x i s added t o , i n o r d e r t o g e t t h e l o c a t i o n o f 
t h e 
v e c t o r . Then t h e f i n a l address i s r e t r i e v e d f r o m t h a t l o c a t i o n . 


I n t h i s new mode, i n d e x e d i n d i r e c t , t h e a c t u a l v e c t o r 
must 
once 
a g a i n be l o c a t e d i n z e r o 
page 
(remember, 
i t can 
s t i l l 
POINT 
anywhere i n memory). T h i s t i m e , however, t h e X - r e g i s t e r 
must 
be 
used f o r t h e i n d e x r a t h e r t h a n Y. 
H e r e ' s an example: 


LDA #$40 
STA $FB 
LDA #$80 
STA $FC 
LDA #$02 
LDX #$2B 
STA ($DO,X) 


Compare t h i s code t o t h e l a s t example. I n t h i s case t h e v e c t o r i s 
s t i l l l o c a t e d a t $FB-FC, 
b u t now i t does p o i n t t o t h e e x a c t f i n a l 
address, $8040, s i n c e no i n d e x w i l l be added 
t o it. The 
i n d e x 
w i l l be used t o FIND t h e v e c t o r . I n t h e STA s t a t e m e n t , f i r s t 
t h e 
i n d e x i s added t o t h e base address 
g i v e n : 
$DO + $2B = $FB. 
The 
r e s u l t , $FB, 
i s t h e LOCATION o f t h e v e c t o r . The CONTENTS 
o f 
t h e 
v e c t o r $FB-FC a r e t h e n r e t r i e v e d 
t o y i e l d 
t h e 
f i n a l 
address, 
$8040. N o t e t h a t t h e p a r e n t h e s e s a r e p u t 
around 
BOTH 
t h e 
base 
address $DO and t h e i n d e x X, 
i n c o n t r a s t t o o u r l a s t example. 


We b r o u g h t up t h e s e d i f f e r e n t 
a d d r e s s i n g modes t o show how 
t h e y 
can be used t o h i d e a memory r e f e r e n c e f r o m p i r a t e s . Even i f t h e 
p i r a t e knows t h a t l o c a t i o n $8040 was changed i n t h e i r 
R A M 
copy, 
t h e r e w o n ' t be any d i r e c t r e f e r e n c e t o 
t h a t 
l o c a t i o n s 
i n y o u r 
program code. 


P i r a t e s a r e p e r s i s t e n t f o l k , so t h e y may t r y a n o t h e r approach. By 
s e a r c h i n g f o r $80 b y t e s and 
$40 
b y t e s 
s e p a r a t e l y , 
t h e y 
m i g h t 
s t i l l be a b l e t o f i n d y o u r p r o t e c t i o n code. They would l o o k f o r a 
p l a c e where t h e two o c c u r n e a r one a n o t h e r i n y o u r 
program. 
To 
d e f e a t t h i s t e c h n i q u e , you can s e p a r a t e t h e use o f $80 and $40 by 
p u t t i n g them i n w i d e l y s c a t t e r e d p a r t s o f t h e 
program, 
such 
as 
d i f f e r e n t s u b r o u t i n e s . O r use $80 and 
$40 
b y t e s 
a l l 
o v e r 
t h e 
p l a c e i n y o u r program, t o g i v e them hundreds o f p l a c e s t o check. 


v 
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Another way t o t h r o w p i r a t e s o f f t h e t r a c k i s t o 
a v o i d 
u s i n g 
a 
$80 o r $40 b y t e e n t i r e l y (assuming t h e address 
w e ' r e 
t r y i n g 
t o 
h i d e i s $8040). 
I n s t e a d , 
t a k e 
some 
v a l u e 
and 
m a n i p u l a t e i t 
m a t h e m a t i c a l l y t o g e t t h e $40 o r $80 v a l u e t h a t you s t o r e i n t h e 
v e c t o r . T h i s t e c h n i q u e amounts t o a f o r m o f e n c r y p t i o n . There a r e 
many d i f f e r e n t i n s t r u c t i o n s you can use t o do t h i s , such as 
I N C , 
I N X , 
I N Y , DEC, DEX, DEY, 
ADC, 
SBC, 
EOR, 
AND, 
OR, 
ASL, 
LSR, 
ROL 
and ROR. W e ' l l c o v e r 
a 
c o u p l e 
o f 
examples 
j u s t 
t o 
g e t 
you 
t h i n k i n g : 


LDA #$7F 
STA $FC 
I N C $FC 


A f t e r t h e I N C i n s t r u c t i o n , l o c a t i o n $FC w i l l c o n t a i n an $80 b y t e , 
t h e c o r r e c t h i g h b y t e o f t h e v e c t o r . 


LDA #$A1 
EOR #$21 
STA $FC 


EOR ( e x c l u s i v e - o r ) i s t h e key i n t h i s example. The v a l u e used 
i n 
t h e EOR i n s t r u c t i o n ($21 
t e l l s which 
b i t s 
i n t h e 
accumulator 


( $ A l l t o f l i p (change f r o m 0 t o 1 o r v i c e v e r s a ) . Any b i t t h a t i s 
a 1 i n t h e EOR v a l u e s p e c i f i e s t h a t t h e c o r r e s p o n d i n g b i t i n t h e 
accumulator s h o u l d be f l i p p e d . C o n v e r t i n g 
t h e 
$A1 
and 
$21 
t o 
b i n a r y w i l l make t h i s example e a s i e r t o f o l l o w : 
$A1 = % I 0 1 0 0001 


and $21 = %0010 0001 ( " % " i n d i c a t e s b i n a r y ) . S i n c e $21 has 1 ' s i n 
b i t s 5 and 0, t h o s e b i t s w i l l be f l i p p e d i n t h e v a l u e 
$ A l . 
T h i s 
w i l l g i v e us % I 0 0 0 0000, which e q u a l s $80. 


Okay, so now t h e p i r a t e c a n ' t f i n d any r e f e r e n c e s t o 
$8040, 
$80 
o r $40. Next t h e y ' l l t r y l o o k i n g f o r a l l 
t h e 
i n s t r u c t i o n s 
t h a t 
use any o f t h e s e " t r i c k y " t y p e s o f a d d r e s s i n g . F o r t u n a t e l y , t h e r e 
a r e many i n s t r u c t i o n s t h a t can use p l a i n 
i n d e x e d 
a d d r e s s i n g 
t o 
change a memory l o c a t i o n : STA, 
DEC, 
I N C , LSR, ASL, 
ROL 
and 
ROR. 
Not o n l y t h a t , b u t p l a i n i n d e x i n g i s v e r y commonly used 
i n many 
programs f o r purposes b e s i d e s p r o t e c t i o n . On t h e o t h e r hand, 
STA 
i s o n l y i n s t r u c t i o n which can use 
i n d i r e c t 
i n d e x e d 
o r 
i n d e x e d 
i n d i r e c t a d d r e s s i n g t o change a memory l o c a t i o n . I f you a r e g o i n g 
t o use t h e s e modes i n y o u r p r o t e c t i o n code, 
you 
s h o u l d 
make 
a 
p o i n t o f u s i n g them i n many o t h e r p a r t s of y o u r program t o o . 


There a r e many v a r i a t i o n s p o s s i b l e on t h e b a s i c theme o f c h a n g i n g 
a RAM copy. You can p u t one o f t h e methods above 
i n s i d e 
a 
l o o p 
and use i t t o w i p e o u t a whole s e c t i o n o f code. You c o u l d s t o r e a 
v a l u e i n t o a l o c a t i o n i n t h e c a r t r i d g e a r e a and t h e n check t o see 
if i t was a c t u a l l y 
changed. 
Record 
t h e 
r e s u l t 
of 
t h e 
check 
t e m p o r a r i l y 
w h i l e 
you 
r e s t o r e 
t h e 
o r i g i n a l 
v a l u e 
t o 
t h a t 
l o c a t i o n . T h i s way t h e l o c a t i o n t h a t was used f o r t h e t e s t 
w o n ' t 


show up d i f f e r e n t i n t h e R A M copy, and p i r a t e s 
w o n ' t 
have 
t h a t 
" f o o t i n t h e d o o r " t o h e l p them f i n d y o u r p r o t e c t i o n code. I f t h e 
l o c a t i o n d i d change when y o u s t o r e d t o it, c r a s h t h e program. 
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Now l e t ' s look a t some other methods 
f o r 
protecting 
cartridges 
t h a t don't involve changing the RAM 
copy. 
One 
s e t 
of 
methods 
involves checking or changing the memory configuration. 
A t t h i s 
point you might want t o review t h e chapter on 
the 
P L A 
and 
the 
chapter on 
cartridges 
and 
c a r t r i d g e boards. 
This 
wi 11 
he1 p 
refresh your memory about t h e relationship between the 
P L A Y the 
cartridge l i n e s GAME and E X R O M , and the memory s e l e c t l i n e s LORAM 
and H I R A M . All these f a c t o r s play 
a part 
in 
determining 
the 
memory configuration. 


The GAME and E X R O M l i n e s are controlled by 
the c a r t r i d g e board 
and force the P L A t o s e l e c t the correct memory configuration 
f o r 
the p a r t i c u l a r type of c a r t r i d g e plugged in. Every c a r t r i d g e must 
ground e i t h e r the GAME or E X R O M l i n e , or both, 
in 
order 
t o be 
switched i n t o memory by the P L A . These l i n e s a r e connected t o the 
cartridge port O N L Y and cannot be changed by 
software, 
so 
they 
are excellent indicators 
of 
whether 
a c a r t r i d g e 
i s actually 
plugged in. Unfortunately, you c a n ' t d i r e c t l y read the s e t t i n g of 
these l i n e s from software t o see i f a c a r t r i d g e 
i s present. 
As 
we'll see, you C A N check these l i n e s i n d i r e c t l y . 


The other two l i n e s t h a t play a part 
in 
selecting 
the memory 
configuration are LORAM and H I R A M . Unlike GAME and 
E X R O M , 
LORAM 


and HIRAM can be checked or changed through 
software 
alone, 
by 
simply reading or writing location 
$0001. 
LORAM 
i s b i t 
0 of 
location $0001 and H I R A M i s b i t 1 . These l i n e s are used t o switch 
the BASIC and K E R N A L R O M S , respectively, i n or 
out 
of 
memory. 
Generally, s e t t i n g one of these l i n e s t o a 1 ( t h e normal s e t t i n g ) 
will switch the corresponding ROM of the 
computer 
i n t o memory; 
s e t t i n g t h e l i n e t o a 0 will switch the ROM out and 
uncover 
the 
RAM underneath i t . However, HIRAM and LORAM 
i n t e r a c t 
with 
GAME 
and E X R O M t o some degree, so t h a t they 
can 
have 
other 
e f f e c t s 
besides j u s t switching a ROM in or out. These s i d e - e f f e c t s can be 
used i n d i r e c t l y t o determine the s t a t e of 
the 
GAME 
and 
E X R O M 
l i n e s and thereby check t h a t the program i s being 
executed 
from 
cartridge. To be on t h e s a f e s i d e , always s e t location 
$0000 
t o 


$ 2 ~ 
AFTER you change H I R A M or LORAM i n location 1 . This will make 
sure t h a t these l i n e s are enabled t o be changed. 


The f i r s t method we're going t o discuss can be used 
with 
e i t h e r 
8K or 16K standard c a r t r i d g e s , b u t not with MAX 
c a r t r i d g e s . 
For 
now, l e t ' s assume we have an 8K cartridge. 8K 
cartridges 
ground 
the E X R O M 
l i n e only, 
which 
t e l l s t h e 
P L A 
will 
enable 
the 
c a r t r i d g e EPROM any time a read i s done from the $8000-9FFF area. 
t h i s means t h e computer will always "see" the c a r t r i d g e memory in 
those areas when reading. When writing, however, the values 
will 
be p u t i n t o the underlying RAM. 


This assumes t h a t the LORAM and 
H I R A M 
b i t s 
are 
s e t 
t o 
t h e i r 
normal value, 1 
(BASIC 
and 
K E R N A L 
switched 
i n ) . 
Interesting 
things happen i f we s e t L O R A M or HIRAM t o 0. For 
instance, 
when 
an 8K c a r t r i d g e i s plugged i n , s e t t i n g LORAM t o 0 s t i l l 
switches 
out the BASIC R O M , 
b u t i t also switches out 
the cartridge. 
You 
can use t h i s s i d e - e f f e c t t o check i f your 
program 
i s actually 
executing in cartridge. 
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H e r e ' s bow t o use t h i s method. Have your program s e t LORAM t o 0, 
using t h e f o l l o w i n g code: 


L D A $01 
A N D #$FE 
STA $01 


This w i l l change b i t 0 ( L O R A M ) of l o c a t i o n $0001 t o a 
0 w i t h o u t 
a f f e c t i n g any o t h e r 
b i t s . 
Now 
r e a d 
from 
a 
l o c a t i o n 
i n 
t h e 


$8000-9FFF a r e a . I f t h e program was e x e c u t i n g i n c a r t r i d g e , 
any 
l o c a t i o n i n t h i s a r e a w i l l change when you s e t LORAM t o 0, 
s i n c e 
t h e c a r t r i d g e w i l l d i s a p p e a r and t h e RAM underneath w i l l 
appear. 
I f t h e program was e x e c u t i n g i n R A M , however, s e t t i n g LORAM t o 0 
w i l l have no e f f e c t on t h e $8000-9FFF a r e a , and t h e l o c a t i o n you 
check w i l l NOT change. J u s t t o b e on t h e s a f e 
s i d e , 
you 
should 
check 
s e v e r a l 
l o c a t i o n s 
s i n c e 
t h e 
underlying 
RAM 
might 
a c c i d e n t a l l y c o n t a i n t h e same v a l u e a s t h e c a r t r i d g e 
i n one 
o r 
two l o c a t i o n s . Pick l o c a t i o n s t h a t d o n ' t c o n t a i n v a l u e s 
such 
a s 
$00 o r $FF i n your c a r t r i d g e , s i n c e t h e s e v a l u e s commonly 
appear 
i n RAM on powerup. I f 
a 
number 
of 
d i f f e r e n t 
l o c a t i o n s 
d o n ' t 


change, t h e n t h e program was d e f i n i t e l y i n RAM. In t h a t c a s e your 
program should t a k e a p p r o p r i a t e s t e p s t o c r a s h i t s e l f . 


You may have n o t i c e d one problem with t h i s method. I f you 
switch 
t h e c a r t r i d g e o u t , t h e r o u t i n e t h a t does 
t h e 
checking 
w i l l 
be 
switched o u t t o o and t h e 
program 
w i l l 
c r a s h 
immediately. 
The 
s o l u t i o n i s t o download your checking r o u t i n e i n t o some 
a r e a 
of 
RAM b e f o r e you s e t L O R A M t o 0. Then t h e r o u t i n e can s a f e l y change 
memory c o n f i g u r a t i o n s w i t h o u t s w i t c h i n g i t s e l f o u t . There 
a r e 
a 
couple of o t h e r t h i n g s 
t h a t 
should 
be 
done 
t o i n c r e a s e 
t h e 
p r o t e c t i o n v a l u e of t h i s method. One i s t o e n c r y p t t h e v e r s i o n of 
t h e r o u t i n e i n t h e c a r t r i d g e and then d e c r y p t i t a s i t i s being 
downloaded t o RAM. A f t e r t h e check, whether i t passes 
o r 
f a i l s , 
t h e c a r t r i d g e should be switched back i n and t h e checking r o u t i n e 
should be wiped o u t of R A M memory. 
Use 
t h e 
f o l l o w i n g 
code 
t o 
switch t h e c a r t r i d g e back i n by changing b i t 0 of l o c a t i o n 
$0001 
t o a 1 : 


L D A $01 
O R A #$01 
STA $01 


Be s u r e t o choose an a r e a of memory 
f o r your 
checking 
r o u t i n e 
t h a t i s normally used by 
t h e 
program 
f o r o t h e r 
purposes, 
o r 
choose a system a r e a l i k e t h e i n p u t b u f f e r a t $0200-58. T h i s 
way 
p i r a t e s w i l l n o t n o t i c e t h a t you wiped an a r e a of memory 
and 
go 
looking f o r t h e program code t h a t does i t . 


HIRAM ( b i t 1 of l o c a t i o n $0001) can be used much t h e same way 
we 
used L O R A M i n t h e l a s t example. S e t t i n g HIRAM t o 0 
s w i t c h e s 
o u t 
t h e K E R N A L R O M , b u t i t a l s o s w i t c h e s o u t 8K c a r t r i d g e s . In 
f a c t , 
HIRAM s w i t c h e s o u t BASIC too. S e t t i n g both HIRAM and L O R A M 
t o 0 


w i l l have t h e same e f f e c t , e x c e p t t h a t t h e 1/0 
d e v i c e s 
w i l l 
be 
switched o u t t o o , l e a v i n g 64K of RAM. 
I f you use HIRAM t o switch 
out your c a r t r i d g e , you must d i s a b l e IRQ i n t e r r r u p t s f i r s t 
( w i t h 
a SEI i n s t r u c t i o n ) . Be s u r e t o e n a b l e i n t e r r u p t s again ( w i t h CLI) 
when you a r e ready t o resume normal o p e r a t i o n s . 
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To s e t H I R A M t o 0, use t h i s code: 


SEI 
LDA $01 
AND #$FD 
( u s e #$FC t o s e t b o t h 
STA $01 
H I R A M and LORAM t o 0 ) 


To s e t H I R A M t o 1, use t h i s code: 


LDA $01 
O R A #$02 
( u s e #$03 t o s e t b o t h 
STA $01 
H I R A M and LORAM t o 1 ) 


CLI 


Now l e t ' s l o o k a t 16K c a r t r i d g e s , which ground b o t h t h e GAME 
and 
EXROM l i n e s . I n t h i s case t h e PLA w i l l e n a b l e t h e f i r s t c a r t r i d g e 
ROM when r e a d i n g f r o m t h e $8000-9FFF area, and e n a b l e t h e 
second 
c a r t r i d g e ROM when r e a d i n g f r o m '$A000-BFFF 
( t h e 
B A S I C 
ROM 
i s 
a u t o m a t i c a l l y s w i t c h e d o u t w i t h 16K c a r t r i d g e s ) . 
The 
p r o t e c t i o n 
method we j u s t c o v e r e d can be used i n e x a c t l y t h e same 
way 
w i t h 
16K c a r t r i d g e s . S e t t i n g LORAM t o 0 w i l l s w i t c h o u t t h e l o w e r h a l f 
o f t h e c a r t r i d g e a t $8000-9FFF, 
b u t l e a v e t h e upper h a l f 
o f 
t h e 
c a r t r i d g e s w i t c h e d i n a t $A000-BFFF. 
S i n c e t h e upper h a l f r e m a i n s 
s w i t c h e d i n , y o u r p r o t e c t i o n code can 
r e s i d e 
t h e r e 
i n s t e a d 
o f 
b e i n g down1 oaded t o RAM. T h i s may be 
c o u n t e r p r o d u c t i v e , 
though, 
because t h e n you w o n ' t be a b l e t o e n c r y p t t h e p r o t e c t i o n code. As 
w i t h 8K c a r t r i d g e s , s e t t i n g H I R A M t o a 
0 
w i l l 
s w i t c h 
o u t 
t h e 
KERNAL ROM and b o t h ROMs o f a 16K c a r t r i d g e . 
B A S I C 
i s s w i t c h e d 
o u t t o o , so a l l you g e t i s RAM 
t h e r e . 
S e t t i n g 
b o t h 
H I R A M 
and 


LORAM t o 0 w i l l do a l l 
t h e s e 
t h i n g s 
and 
s w i t c h 
o u t 
t h e 
1/0 
d e v i c e s t o o . 


16K c a r t r i d g e s o f f e r t h e o p p o r t u n i t y t o 
use 
a n o t h e r 
p r o t e c t i o n 
method t h a t i n v o l v e s LORAM. R e c a l l 
t h a t 
t h e 
PLA 
a u t o m a t i c a l l y 
s w i t c h e s o u t t h e B A S I C 
ROM 
f o r 
16K 
c a r t r i d g e s , 
w i t h o u t 
y o u r 
c a r t r i d g e h a v i n g t o s e t LORAM t o 0. T h i s means 
t h a t i f p i r a t e s 
want t o r u n y o u r c a r t r i d g e f r o m RAM, 
t h e y 
must 
s w i t c h 
o u t 
t h e 
B A S I C ROM themselves f i r s t , u s i n g LORAM. There a r e two t h i n g s you 
can do t o d e f e a t them. The f i r s t i s t o s i m p l y check t h e LORAM b i t 
a t some p o i n t and c r a s h t h e program i f i t i s a 
0. 
The 
o t h e r 
t e c h n i q u e i s t o t r y t o switch the BASIC ROM back in b y 
s e t t i n g 


LORAM t o a 1. I f t h e program i s on c a r t r i d g e , t h i s w i l l n o t 
harm 
a n y t h i n g . I f t h e program i s i n RAM, 
however, t h e B A S I C 
ROM 
w i l l 
come back i n on t o p o f t h e second h a l f of t h e program and p r e v e n t 
i t f r o m r u n n i n g . Remember t o s e t 
l o c a t i o n 
$0000 
t o 
$2F 
AFTER 
c h a n g i n g LORAM, t o make s u r e t h e change w i l l t a k e e f f e c t . 


Now a few words about M A X c a r t r i d g e s . These ground t h e GAME 
l i n e 
o n l y and appear a t $E000-FFFF i n memory ( t h e KERNAL 
i s s w i t c h e d 
o u t a u t o m a t i c a l l y ) . O p t i o n a l l y , t h e second c a r t r i d g e 
EPROM 
w i l l 
appear a t $8000-9FFF i f i t i s used ( v e r y r a r e ) . These 
c a r t r i d g e s 
can be p r o t e c t e d by a t t e m p t i n g t o w r i t e o v e r themselves t o 
c r a s h 
any RAM copy. T r y i n g t o s w i t c h i n t h e KERNAL sounds l i k e a 
good 
i d e a , b u t H I R A M and LORAM have NO EFFECT w i t h MAX c a r t r i d g e s . 
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O u r f i n a l s e t of p r o t e c t i o n methods i s r e a l l y open-ended, 
w i t h 
many p o s s i b i l i t i e s . I f y o u r 8K o r 16K c a r t r i d g e uses 
t h e 
CBM80 


a u t o s t a r t key, you can t a k e advantage of 
t h e 
f a c t 
t h a t 
almost 
none of t h e 
normal 
RESET 
i n i t i a l i z a t i o n 
i s done 
b e f o r e 
t h e 
c a r t r i d g e i s s t a r t e d ( s e e t h e c h a p t e r on 
a u t o s t a r t 
c a r t r i d g e s ) . 
What 
good 
does 
t h i s 
do 
you? 
Well, 
t h e 
computer 
must 
be 
i n i t i a l i z e d b e f o r e a p i r a t e can load your program from 
d i s k 
and 
r u n i t i n RAM. The i n i t i a l i z a t i o n p r o c e s s w i l l 
p l a c e 
p a r t i c u l a r 
values i n many l o c a t i o n s , e s p e c i a l l y low memory ($0000-03FF), t h e 
VIC c h i p and t h e CIA c h i p s . By checking 
one 
o r more 
of 
t h e s e 
l o c a t i o n s , 
you 
can 
d e t e c t 
whether 
t h e 
computer 
has 
been 
i n i t i a l i z e d y e t and c r a s h t h e program i f i t has. 


I t may be b e s t t o check l o c a t i o n s t h a t your program 
i t s e l f 
does 
not use. A t l e a s t , you should 
be 
a b l e 
t o postpone 
using 
t h e 
l o c a t i o n o r c a l l i n g t h e system r o u t i n e t h a t i n i t i a l i z e s i t . 
This 
way you can put y o u r check f u r t h e r on i n t o your program ( t h e more 
deeply " b u r i e d " , t h e b e t t e r ) . Otherwise y o u ' l l probably 
have 
t o 
do your check near t h e beginning of your program. T h i s 
makes 
i t 
t o o easy f o r a p i r a t e who i s t r a c i n g through y o u r code t o uncover 
your p r o t e c t i o n . Also, 
you 
should 
pick 
l o c a t i o n s 
t h a t 
d o n ' t 
change i n normal use, 
s o y o u ' l l 
know 
a 
d e f i n i t e v a l u e 
t h a t 
i n d i c a t e s i n i t i a l i z a t i o n has taken p l a c e . You probably 
s h o u l d n ' t 
check l o c a t i o n s t h a t a r e i n i t i a l i z e d t o $00 o r $FF, 
s i n c e 
t h e s e 
v a l u e s a r e o f t e n found i n memory a t random l o c a t i o n s on powerup. 


One memory a r e a 
i n p a r t i c u l a r 
i s worth 
mentioning, 
i f 
o n l y 
because i t has been used i n many commercial c a r t r i d g e s . When 
t h e 
computer i s RESET ( a s on powerup), t h e CIA c h i p s a r e RESET 
t o o . 
This s t o p s a l l of t h e i r t i m e r s from 
running 
and 
s e t s them 
t o 
z e r o , i n c l u d i n g t h e t i m e r t h a t i s used 
t o g e n e r a t e 
t h e 
normal 
system IRQ i n t e r r u p t s . T h i s i s Timer A 
of 
CIA # I , 
l o c a t e d 
a t 


$DC04-05. During 
normal 
RESET 
i n i t i a l i z a t i o n , 
t h i s 
t i m e r 
i s 
s t a r t e d up by t h e IOINIT r o u t i n e ($FDA3). I f 
t h i s 
t i m e r 
has 
a 
non-zero v a l u e when your program checks i t , you can be s u r e t h a t 
i n i t i a l i z a t i o n 
has 
been 
done. 
Time 
t o c r a s h 
t h e 
program! 
A c t u a l l y , t h i s p a r t i c u l a r l o c a t i o n has been used s o much 
and 
i s 
s o well known among c a r t r i d g e p i r a t e s t h a t i t should probably 
be 
avoided. 


BASIC's system RAM l o c a t i o n s may 
be 
p e r f e c t 
p l a c e s 
t o check, 
e s p e c i a l l y i f you d o n ' t use t h e corresponding BASIC 
s u b r o u t i n e s . 
Most of BASIC's i n i t i a l i z a t i o n i s done by 
s u b r o u t i n e s 
a t $E453 


and $E36F. BASIC's a r e a s must be i n i t i a l i z e d f o r a 
L O A D 
o r 
R U N 
command, which w i l l have t o be used t o e x e c u t e a p i r a t e d RAM copy 
from d i s k . 
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C128 CARTRIDGES 


The Commodore 128 i s a s u b s t a n t i a l upgrade of t h e 
Commodore 
64. 
I t seems as i f nearly every f e a t u r e of t h e C64 has been 
enhanced 
i n t h e new C128, 
and 
c a r t r i d g e s 
a r e 
no 
exception. 
( I n t h i s 
chapter, "C128" g e n e r a l l y r e f e r s t o t h e 
new 
128 mode 
of 
t h e 
computer. The 64 mode i s v i r t u a l l y i d e n t i c a l t o t h e C64 machine). 
The maximum c a r t r i d g e s i z e has been 
doubled 
t o 32K, 
an 
E P R O M 
socket has been provided i n s i d e t h e machine i n 
addition 
t o t h e 
usual c a r t r i d g e p o r t , a more f l e x i b l e c a r t r i d g e a u t o s t a r t 
system 
has been 
imp1 emented, 
two 
s e p a r a t e 
" l o g i c a l 
c a r t r i d g e s " 
can 
r e s i d e on t h e 
same 
physical 
c a r t r i d g e 
and 
w i l l 
be 
executed 
independently of each o t h e r , and more! To t o p i t o f f , a l l of 
t h e 
c a r t r i d g e c o n f i g u r a t i o n s can be s e l e c t e d through 
software 
alone 
r a t h e r than r e l y i n g on t h e c a r t r i d g e hardware (GAME and E X R O M a r e 
not used i n 128 mode). We'll t r y t o give you an overview 
of 
a l l 
t h e new c a r t r i d e f e a t u r e s and c o n f i g u r a t i o n s , 
as 
well 
a s 
t h e 
e s s e n t i a l d e t a i 9 s y o u ' l l need t o c r e a t e your own C128 c a r t r i d g e s . 


L e t ' s s t a r t by looking a t where 
c a r t r i d g e s 
can 
r e s i d e 
i n 
t h e 


C128's memory space. Recall t h a t 
an 
8 - b i t 
processor 
can 
only 
"look" a t 64K of memory space a t one time. ( t h e C128 
c o n t a i n s 
a 
new 8502 processor t h a t can be considered i d e n t i c a l t o t h e 
C64's 


6510 
processor 
f o r 
our 
purposes). 
O n 
t h e C64, 
a 
special 
bank-switching technique i s used t o switch t h e BASIC R O M , 
K E R N A L 
R O M , 110 devices and c a r t r i d g e s i n o r out of 
t h e memory 
space. 
Bank-switching i s a l s o used on t h e C128, 
f o r 
switching 
i n 64K 
banks of RAM as well a s system ROMs, c a r t r i d g e s , 
e t c . 
The 
main 
d i f f e r e n c e on t h e C128 i s t h a t t h e bank-switching 
i s much 
more 
e l a b o r a t e and f l e x i b l e . This i s especi a1 l y t r u e f o r c a r t r i d g e s . 


There are'two a r e a s of C128 memory t h a t c a r t r i d g e s can appear i n . 
They a r e c a l l e d t h e MID 
SPACE 
($8000-BFFF) 
and 
t h e 
HI 
SPACE 


($C000-FFFF). 
Note t h a t each a r e a i s 16K long. This means 
u p 
t o 
32K of c a r t r i d g e memory can be 
switched 
i n t o t h e 
C128 
memory 
space simultaneously! In normal o p e r a t i o n , t h e mid space c o n t a i n s 
p a r t of t h e BASIC system ($8000-AFFF) and 
t h e 
b u i l t - i n 
machine 
language monitor ($B000-BFFF). The hi space normally c o n t a i n s t h e 
screen e d i t o r ($C000-CFFF), t h e 110 devices ($D000-DFFF) and 
t h e 
K E R N A L ($E000-FFFF). 


The 
mid 
space 
and 
h i 
space 
a r e 
c o n t r o l l e d 
completely 
independently of each o t h e r . Through software, you have a 
choice 
of f o u r types of memory t h a t 
can 
appear 
i n 
each 
space: 
RAM, 
external c a r t r i d g e R O M , speci a1 INTERNAL ROM, 
o r 
normal 
system 
ROM (BASIC, e t c . ) . The i n t e r n a l ROM i s s i m i l a r 
t o an 
external 
c a r t r i d g e . I n s i d e t h e C128 i s an empty 28-pin socket. To 
g e t 
a t 
i t , y o u ' l l not only have t o void your warranty 
b u t 
y o u ' l l 
a l s o 
have t o unsolder t h e metal heat 
sink/RFI 
s h i e l d . 
The 
i n t e r n a l 
socket can hold e i t h e r a 16K o r a 32K chip. I f a chip i s i n s e r t e d 
t h e r e , i t w i l l be recognized by t h e 
computer 
and 
t r e a t e d 
j u s t 
l i k e an external c a r t r i d g e . When we use 
t h e word 
c a r t r i d g e 
i n 
t h i s chapter, 
w e ' l l 
u s u a l l y 
mean 
t o 
include 
t h i s 
" i n t e r n a l 
c a r t r i d g e " . 
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L e t ' s see how you can s e l e c t which type of memory w i l l appear 
i n 
t h e mid and 
hi 
spaces. 
Recall 
t h a t 
on 
t h e 
C64, 
memory 
i s 
controlled by t h e P L A . The P L A i n t u r n i s c o n t r o l l e d by t h e 
GAME 
and E X R O M l i n e s of t h e c a r t r i d g e port and 
t h e 
L O R O M 
and 
HIROM 
l i n e s t h a t appear i n l o c a t i o n 
$0001. 
On 
t h e 
C128, 
memory 
i s 
managed by a new chip 
c a l l e d 
t h e 
MEMORY MANAGEMENT UNIT (MMU). 


The P L A and l o c a t i o n $0001 a r e not used f o r memory management 
in 
128 mode. 


The M M U i s l o c a t e d i n memory a t 
$D500-OB. 
In 
addition 
t o t h e 
PRIMARY M M U REGISTERS i n t h e $D500 a r e a , 
t h e 
M M U 
can 
a l s o 
be 
accessed through i t s SECONDARY REGISTERS located a t $FF00-04. The 
secondary M M U r e g i s t e r s a r e present i n a l l memory c o n f i g u r a t i o n s , 
regardless of whether system R O M , c a r t r i d g e ROM o r RAM 
has 
been 
s e l e c t e d f o r t h e hi space. They form 
a 
"hole" 
i n 
memory 
t h a t 
c a n ' t be covered u p ( d o n ' t p u t any c a r t r i d g e code i n t h e $FF00-04 
a r e a ) . The reason t h i s was s e t u p i s t h a t i t ' s p o s s i b l e t o switch 
out t h e e n t i r e 110 block ($D000-DFFF), including t h e primary 
M M U 
r e g i s t e r s . The secondary r e g i s t e r s a r e provided so you can switch 
t h e primary r e g i s t e r s back i n ! 
You 
may 
need 
t h e 
primary 
M M U 
r e g i s t e r s because t h e secondary 
r e g i s t e r s 
d o n ' t 
have 
a l l 
t h e 
c a p a b i l i t i e s 
of 
t h e 
primary 
r e g i s t e r s . 
We 
won't 
need 
t h e 
secondary r e g i s t e r s f o r our purposes, however. 


In f a c t , t h e only primary M M U r e g i s t e r we 
r e a l l y 
have 
t o deal 
with 
i s 
CONFIGURATION REGISTER 1 (CR1). 
The 
C R 1 
r e g i s t e r 
i s 
located a t $D500 ( t h e secondary r e g i s t e r a t $FFOO i s c a l l e d 
CR2 
and follows t h e same 
format 
as 
CR1). 
Figure 
10-1 
l i s t s t h e 
function of each b i t of CR1. 


Figure 10-1: MMU CONFIGURATION REGISTER 


Bit - Function 
Options 


7-6 
RAM bank 
OO=bank 0, 
Ol=bank 1 , 
e t c . 


5-4 
Hi space 
OO=System R O M , 
1 O=External R O M , 
3-2 
Mid space 
Ol=Internal R O M , 
11=RAM 


1 
Lo space 
O=System R O M , 
1=RAM 


0 
$DO00 a r e a 
O=I/O devices, 
l=System ROM 


We 
need t o look more c l o s e l y a t two 
p a r t i c u l a r 
p a i r s 
of 
b i t s . 
B i t s 5-4 control t h e hi space and b i t s 3-2 control t h e mid space. 
Each b i t p a i r follows t h e same format. S t o r i n g a $00 value i n t o a 
b i t p a i r w i l l switch i n t h e system ROM t h a t normally occupies t h e 
corresponding space. S t o r i n g a value of $01 i n a 
b i t 
p a i r 
w i l l 
switch i n half (16K) of 
t h e 
s p e c i a l 
i n t e r n a l 
ROM 
i n s t e a d 
of 
system R O M . S t o r i n g a $10 
value 
w i l l 
switch 
i n 
half 
of 
t h e 
external ROM ( c a r t r i d g e ) memory. F i n a l l y , s t o r i n g a value of 
$11 
i n a b i t p a i r w i l l 
switch 
RAM 
i n t o 
t h e 
corresponding 
space. 
T h a t ' s a l l t h e r e i s t o i t - j u s t decide what you want 
t o 
appear 
in t h e mid o r hi space, then s e t t h e corresponding 
b i t 
p a i r 
t o 
t h e c o r r e c t value. 
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Now t h a t we know HOW t o switch i n c a r t r i d g e memory, 
we 
have 
t o 
consider how t h e system knows W H E N t o switch i n a c a r t r i d g e . 
I t 
c a n ' t depend on t h e P L A 
t o 
switch 
t h e 
c a r t r i d g e 
i n t o memory 
automatically based on t h e GAME and E X R O M l i n e s . Neither t h e 
P L A 
nor t h e G A M E I E X R O M l i n e s a r e used i n t h e C128 mode. The C128 
has 
t o switch t h e c a r t r i d g e i n t o memory i t s e l f through t h e 
M M U 
when 
i t ' s time t o r u n t h e c a r t r i d g e . B u t f i r s t i t has 
t o f i g u r e out 
t h a t t h e r e ' s a c a r t r i d g e plugged in a t a l l . 


To see i f 
t h e r e 
a r e 
any 
c a r t r i d g e s 
plugged 
i n , 
t h e 
system 
conducts a poll of a l l t h e p o s s i b l e c a r t r i d g e a r e a s ( i n t e r n a l 
o r 
e x t e r n a l , hi space o r mid s p a c e ) . This i s done during t h e 
system 
RESET r o u t i n e , using a subroutine c a l l e d P O L L located a t $E242-BB 
i n t h e K E R N A L ( a l l r e f e r e n c e s t o t h e C128 K E R N A L a r e based 
on 
a 
version labeled 318020-03 on t h e c h i p ) . The f i r s t t h i n g P O L L does 
i s check t h e GAME and E X R O M l i n e s . I f e i t h e r l i n e i s grounded, i t 
i n d i c a t e s t h a t a C64 c a r t r i d g e i s plugged i n . In t h i s case, 
P O L L 
w i l l automatically j u m p i n t o 
64 
mode. 
Otherwise, 
P O L L 
begins 
checking t h e 128 c a r t r i d g e a r e a s . P O L L checks t h e c a r t r i d g e a r e a s 
i n t h e following order: external mid, e x t e r n a l h i , 
i n t e r n a l 
mid 
and f i n a l l y , i n t e r n a l h i ( i . e . , external 
before 
i n t e r n a l , 
mid 
before h i ) . 


In each of 
t h e 
c a r t r i d g e 
a r e a s , 
P O L L 
checks 
f o r 
a 
s p e c i a l 
c a r t r i d g e key s t r i n g s t a r t i n g a t r e l a t i v e byte $07. For 
example, 
in t h e mid space ($8000-BFFF) P O L L w i l l s t a r t checking a t $8007. 
The c a r t r i d g e key s t r i n g on t h e C128 
i s t h e 
l e t t e r s 
CBM 
( n o t 


CBM80 l i k e t h e C64). Besides t h e CBM s t r i n g , 
t h e 
c a r t r i d g e 
key 
contains a cold and warm s t a r t e n t r y point and 
a c a r t r i d g e 
ID. 
Figure 10-2 shows t h e complete format f o r t h e c a r t r i d g e key. 


Figure 10-2: CARTRIDGE KEY 


Bytes 
Description 


x000-02 
Cold s t a r t e n t r y 


xOO3-05 
Warm s t a r t e n t r y 


x006 
C a r t r i d g e ID byte 


xOO7-09 
"CBM" s t r i n g 


Note: x = $8 (mid) o r $C ( h i ) 


If t h e CBM i s found i n a 
p a r t i c u l a r 
c a r t r i d g e 
a r e a , 
t h e 
P O L L 
r o u t i n e " l o g s i n " t h e c a r t r i d g e by recording t h e 
ID 
byte 
i n 
a 
special 
t a b l e . 
This 
t a b l e 
i s 
c a l l ed 
t h e 
PHYSICAL ADDRESS TABLE (PAT) and i t i s located a t 
$OAC1-C4. 
The 


ID'S a r e stored here i n r e v e r s e of t h e order they 
were 
checked, 


e.g., 
$OAC4 holds t h e f i r s t a r e a ' s ID ( t h e external mid ID). 
The 
PAT i s c l e a r e d by f i l l i n g i t with $00 bytes 
before 
P O L L 
begins 
checking f o r c a r t r i d g e s . 
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After s t o r i n g an ID i n t h e PAT, 
and 
before 
checking 
t h e 
next 
area, P O L L checks 
t o 
s e e 
i f 
t h e 
c a r t r i d g e 
i t found 
i s an 
a u t o s t a r t c a r t r i d g e . 
Any 
c a r t r i d g e 
t h a t 
has 
an 
I D = $01 
i s 
considered an a u t o s t a r t c a r t r i d g e . I f 
P O L L 
f i n d s 
an 
a u t o s t a r t 
c a r t r i d g e , i t immediately switches i n t h e c a r t r i d g e area and does 
a JSR t o t h e cold s t a r t e n t r y i n 
t h e 
c a r t r i d g e 
key. 
Actually, 
P O L L always switches i n both t h e mid and hi space c a r t r i d g e areas 
together. Your c a r t r i d g e can switch 
t h e 
o t h e r 
c a r t r i d g e 
space 
back out i f so d e s i r e d . 


NOTE: The cold s t a r t e n t r y i s an e n t r y p o i n t , NOT a vector ( i t i s 
t h r e e bytes long, not two). 
P O L L 
does 
not 
JSR 
based 
on 
t h e 
CONTENTS of t h e cold s t a r t e n t r y , i t JSR's d i r e c t l y TO 
t h e 
cold 
s t a r t e n t r y p o i n t . P O L L expects t o encounter 
executable 
machine 
code t h e r e . Normally, t h i s w i l l be a JMP t o t h e actual 
s t a r t of 
t h e c a r t r i d g e code. The warm s t a r t e n t r y i s supposed t o be s e t u p 
t h e same way, b u t i t ' s never used by t h e system. 


Since P O L L does a JSR 
t o an 
a u t o s t a r t 
c a r t r i d g e r a t h e r 
than 


JMPing t o i t , t h e c a r t r i d g e has a choice of whether i t wants 
t o 
r e t u r n t o P O L L o r not. I f a l l t h e c a r t r i d g e needs t o do 
a t 
t h i s 
point i s some i n i t i a l i z a t i o n , i t can do so and then 
r e t u r n 
back 
t o P O L L 
v i a 
an 
RTS. 
I f 
t h e 
c a r t r i d g e wants 
t o t a k e 
over 
completely, i t can do so by simply never r e t u r n i n g t o P O L L . 
This 
i s more convenient than t h e arrangement on t h e C64. 


If no CBM s t r i n g was found i n a p a r t i c u l a r 
a r e a , 
t h e 
PAT 
w i l l 
contain a $00 ID byte f o r t h a t area. As 
f a r as 
t h e 
system 
i s 
concerned, no c a r t r i d g e e x i s t s t h e r e . You might a c t u a l l y 
have 
a 
c a r t r i d g e plugged i n , b u t without t h e CBM s t r i n g t h e system 
w i l l 
never switch i t i n o r t r y t o execute i t . For t h a t matter, even i f 
t h e r e i s a CBM s t r i n g , i f t h e ID i n t h e key i s $00 t h e 
c a r t r i d g e 
will never 
be 
c a l l e d . 
Of 
course, 
you 
s t i l l 
can 
execute 
a 
c a r t r i d g e yourself "manually". You'll 
have 
t o 
switch 
i t i n t o 
memory and j u m p t o i t using a special r o u t i n e i n low 
RAM 
(below 
$4000). 


n l e s s an a u t o s t a r t 
c a r t r i d g e 
t a k e s 
over 
c o n t r o l , 
P O L L 
w i l l 
ontinue t o search a l l f o u r of t h e p o s s i b l e c a r t r i d g e 
a r e a s 
and 
og in any c a r t r i d g e s i t f i n d s . When P O L L 
i s done, 
t h e 
normal 
ystem RESET process w i l l continue. The l a s t major 
s t e p 
i n 
t h e 


.ESET process (under normal c o n d i t i o n s ) 
i s t o 
c a l l 
t h e 
BASIC 
system's i n i t i a l i z a t i o n r o u t i n e through t h e SYSTEM 
V E C T O R . 
This 
vector i s located a t $OA00-01. I t i s i n i t i a l i z e d t o point t o t h e 
s t a r t of BASIC ($4000) by t h e RAMTAS r o u t i n e a t $E093-CC. 


When BASIC has f i n i s h e d 
i t s i n i t i a l i z a t i o n , 
i t c a l l s 
upon 
a 
speci a1 
r o u t i n e 
c a l l ed 
PHOENIX 
a t 
$F867-8F 
(a1 so 
reachable 
through a new K E R N A L j u m p t a b l e e n t r y a t $FF56). 
PHOENIX 
checks 
through t h e PAT t o s e e i f any c a r t r i d g e s have been logged i n . 
I t 
checks t h e PAT i n t h e same order 
t h a t 
P O L L 
uses, 
s t a r t i n g 
a t 


$OAC4 ( e x t e r n a l mid) and ending a t $OAC1 ( i n t e r n a l h i ) . 
Any 
PAT 
e n t r y (ID) of $00 i s skipped. I f a non-$00 ID i s found, 
PHOENIX 
immediately switches i n t h e c a r t r i d g e 
and 
does 
a 
JSR 
t o t h e 
c a r t r i d g e ' s cold s t a r t e n t r y . I t knows which c a r t r i d g e t o 
switch 
i n ( i n t e r n a l or e x t e r n a l ) by t h e ID'S l o c a t i o n i n t h e PAT. 
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As w i t h P O L L , c a r t r i d g e s have a choice of 
returning 
t o PHOENIX 
v i a an RTS (perhaps a f t e r patching i n t o some system v e c t o r s ) , 
o r 
taking over completely by never 
r e t u r n i n g . 
I f 
a c a r t r i d g e 
i s 
executed b u t r e t u r n s 
t o 
PHOENIX, 
then 
PHOENIX 
w i l l 
continue, 
stepping through t h e 
PAT, 
executing 
any 
c a r t r i d g e s i t comes 
across. I f and when PHOENIX f i n i s h e s checking a l l 
four 
ID'S 
i n 
t h e PAT, i t f a l l s through t o another new r o u t i n e c a l l e d BOOT C A L L 
a t $F890 (new K E R N A L c a l l $FF53). BOOT C A L L 
checks 
t h e c u r r e n t 
d r i v e f o r an autoboot d i s k ( a n o t h e r new f e a t u r e of t h e C128). 
If 
t h e special d i s k boot key ( a l s o a CBM s t r i n g ) i s found a t s e c t o r 
1/0, t h e i n d i c a t e d program 
o r 
s e t of 
s e c t o r s 
i s loaded 
and 
executed. 
Otherwise, 
BOOT C A L L 
w i l l 
r e t u r n 
t o 
BASIC 
i n i t i a l i z a t i o n , which w i l l t e r m i n a t e i n t h e f a m i l i a r READY mode. 


As you can see, t h e C128 handles c a r t r i d g e s much d i f f e r e n t l y than 
t h e C64. Perhaps a quick review of t h e process would help a t t h i s 
point. There a r e f o u r p o s s i b l e 
a r e a s 
where 
a 
c a r t r i d g e might 
r e s i d e . These a r e a s a r e checked on RESET by t h e P O L L r o u t i n e . 
I f 
POLL f i n d s a CBM c a r t r i d g e key i n an a r e a , t h e c a r t r i d g e w i l l 
be 
l o ed i n by s t o r i n 
i t s ID i n t h e PAT t a b l e . Otherwise a $00 
ID 


wig! 
s t o r e d i n t h e ! 
AT e n t r y f o r t h a t area. Any c a r t r i d g e with an 
ID of $01 w i l l be executed immediately by P O L L using a JSR t o t h e 
. cold s t a r t e n t r y point. Unless an a u t o s t a r t c a r t r i d g e t a k e s 
over 
f o r good, P O L L w i l l continue t o look 
f o r 
c a r t r i d g e s 
u n t i l 
a l l 
a r e a s have been checked. 


Eventually, 
BASIC 
w i l l 
be 
i n i t i a l i z e d . 
As 
p a r t 
of 
i t s 
i n i t i a l i z a t i o n , 
i t c a l l s 
upon 
t h e 
PHOENIX 
r o u t i n e . 
PHOENIX 
searches 
t h e 
PAT 
( n o t t h e 
c a r t r i d g e 
a r e a s ) 
f o r 
logged-in 
c a r t r i d g e s and executes any i t f i n d s , again using JSR. I f none of 
t h e c a r t r i d g e s t a k e over c o n t r o l , t h e d i s k w i l l be checked f o r a 
d i s k autoboot key. I f i t i s found, t h e disk w i l l 
be 
autobooted. 
Otherwise, control w i l l 
be 
turned 
over 
t o t h e 
user 
through 
BASIC's R E A D Y mode. 


There a r e s t i l l a couple of loose ends t h a t must be 
t i e d 
u p 
t o 
complete our discussion of C128 c a r t r i d g e s . For i n s t a n c e , when we 
speak of t h e system switching i n a c a r t r i d g e , i t ' s important 
t o 
know e x a c t l y what memory c o n f i g u r a t i o n w i l l be chosen. 
The 
C128 
has a s e t of c o n f i g u r a t i o n s t h a t 
can 
be 
referenced 
by 
number 
r a t h e r than having t o f i g u r e out t h e c o r r e c t value t o p u t i n t h e 
MMU's configuration r e g i s t e r . These a r e t h e 
same 
c o n f i g u r a t i o n 
numbers t h a t a r e l i s t e d f o r use with t h e b u i l t - i n ML 
monitor 
on 
p . 372 of t h e System Guide t h a t comes w i t h t h e C128. 


The actual value placed i n t h e M M U f o r each c o n f i g u r a t i o n 
number 
( c f g # ) i s given i n a t a b l e located i n t h e 
K E R N A L 
a t $F7FO-FF. 


Cfg #O uses t h e f i r s t value i n t h e t a b l e ($3F) and 
so 
on. 
When 
t h e C128 switches i n a c a r t r i d g e 
t o check 
f o r 
a 
CBM 
key 
o r 
execute t h e c a r t r i d g e , i t uses 
a 
d i f f e r e n t 
cfg# 
depending 
on 
whether i t i s an i n t e r n a l o r e x t e r n a l c a r t r i d g e . The same cfg# i s 
used r e g a r d l e s s of whether t h e c a r t r i d g e i s i n hi 
space 
o r 
l o 
space - both c a r t r i d g e 
spaces 
a r e 
switched 
i n 
t o g e t h e r . 
For 
i n t e r n a l c a r t r i d g e s , cfg #4 i s used, and t h e value $16 i s placed 
i n t h e MMU's c o n f i g u r a t i o n 
r e i s t e r . 
For 
external 
c a r t r i d g e s , 
cfg #8 i s used, and t h e value 3 2 A i s placed i n t h e M M U . 
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N o t e t h a t b o t h c a r t r i d g e spaces ( m i d and h i ) a r e a l w a y s 
s w i t c h e d 
i n t o g e t h e r , even 
t h o u g h i t i s p o s s i b l e 
t o 
s w i t c h 
them 
i n 
i n d e p e n d e n t l y o f each 
o t h e r . 
You 
may 
o n l y 
want 
one 
o f 
t h e 
c a r t r i d g e spaces s w i t c h e d i n f o r y o u r c a r t r i d g e . F o r example, 
i f 
y o u a r e s e t t i n g up a 16K c a r t r i d g e i n m i d 
space, 
y o u 
may 
w e l l 
want t h e system ROMs s w i t c h e d i n t o h i space so y o u 
can 
u s e 
t h e 
KERNAL. Your c a r t r i d g e i t s e l f w i l l have t o s w i t c h t h e system ROMs 
back i n t o h i space. The c a r t r i d g e c a n do t h i s b y 
s i m p l y 
p u t t i n g 
t h e v a l u e $OA i n t o CR2 ($FFOO). I n g e n e r a l , i t ' s a good 
i d e a 
t o 
always u s e CR2 r a t h e r t h a n t h e p r i m a r y c o n f i g u r a t i o n r e g i s t e r CR1 
because CR2 i s ALWAYS i n memory. S i n c e CR1 can be s w i t c h e d o u t b y 
s w i t c h i n g o u t t h e 110 d e v i c e s , u s i n g CR2 i s b e t t e r i n g e n e r a l . 


O t h e r c a r t r i d g e s , i n t e r n a l o r e x t e r n a l , m i d o r h i , may a l s o 
need 
t o change t h e 
memory 
c o n f i g u r a t i o n 
a f t e r 
t h e y 
a r e 
e x e c u t e d . 
Perhaps t h e y need RAM i n an area, o r want t o u s e t h e 
KERNAL. 
I n 
any case, t h e c a r t r i d g e s h o u l d d i s a b l e I R Q i n t e r r u p t s w i t h an SEI 
i n s t r u c t i o n as soon as t h e c a r t r i d g e i s e x e c u t e d , 
b e f o r e 
t r y i n g 
t o 
change 
t h e 
memory 
c o n f i g u r a t i o n . 
The 
I R Q 
r o u t i n e 
c o u l d 
p o t e n t i a l l y c a l l on s u b r o u t i n e s i n b o t h 
t h e 
KERNAL 
and 
BASIC 
ROMs, 
so i t ' s b e s t 
t o 
d i s a b l e 
i n t e r r u p t s 
i n a l l 
s i t u a t i o n s . 
Y o u ' l l p r o b a b l y want t o e n a b l e i n t e r r u p t s 
a g a i n 
a f t e r 
c h a n g i n g 
t h e memory c o n f i g u r a t i o n . 


We've i n c l u d e d a sample C128 c a r t r i d g e 
on 
t h e 
d i s k 
w i t h 
t h i s 
book. When i t i s e x e c u t e d , i t d e m o n s t r a t e s a c o u p l e new 
f e a t u r e s 
o f t h e C128 and t h e n r e t u r n s t o BASIC. To s e t i t up, y o u ' l l 
need 
a 27128 (16K) E P R O M and a PC2 
c a r t r i d g e 
b o a r d 
( b o t h 
a v a i l a b l e 
f r o m CSM). By t h e way, when y o u buy 
EPROMS 
f o r 
t h e 
C128, 
y o u 
s h o u l d g e t ones r a t e d a t 250 ns. o r f a s t e r , i n o r d e r t o be 
a b l e 
t o u s e them i n t h e 
C128's 
new 
2MHz 
mode. 
I n t h i s 
mode 
t h e 
p r o c e s s o r r u n s t w i c e as f a s t as n o r m a l , so t h e memory c h i p s 
must 
be f a s t e r t o keep up w i t h it. 


Y o u ' l l have t o b u r n t h e 27128 EPROM u s i n g a C64 o r t h e C128 i n 6 4 
mode, s i n c e t h e r e i s no C128 v e r s i o n o f PROMOS ( a t 
l e a s t 
as 
o f 
1 1 / 8 5 ) . Power o f f t h e computer, p l u g i n t h e PROMENADE 
and 
power 
t h e computer on a g a i n . If 
y o u ' r e u s i n g a C128, go i n t o 64 mode b y 
e i t h e r h o l d i n g down t h e C= k e y as y o u s w i t c h t h e computer on, 
o r 
t y p i n g GO64 a f t e r t h e computer comes up i n 128 
mode. 
Load 
and 
e x e c u t e b o t h PROMOS and y o u r machine l a n g u a g e m o n i t o r 
as 
u s u a l . 
Now i n s e r t t h e p r o g r a m 
d i s k 
f o r 
t h i s 
book 
and 
l o a d 
i n t h e 
c a r t r i d g e f i l e b y e n t e r i n g : 


L "128 CARTRIDGE", 
08 


The c a r t r i d g e w i l l l o a d i n a t $2000 as u s u a l t o make b u r n i n g 
t h e 
EPROM e a s i e r , even t h o u g h i t w i l l r e s i d e a t $8000 i n t h e computer 
e v e n t u a l l y . I n i t i a l i z e t h e PROMENADE w i t h a "Z" command. 
I n s e r t 
t h e 27128 i n t o t h e PROMENADE w i t h t h e n o t c h t o t h e l e f t as u s u a l , 
and f l i p t h e l e v e r down. The command t o b u r n t h e EPROM i s : 
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D O N ' T type t h e l e t t e r s PI, use t h e pi key on t h e 
keyboard 
(next 
t o t h e RESTORE key). This command only programs a small amount of 
memory, so i t should only t a k e a few seconds. I f you a r e using 
a 


27128A E P R O M , be s u r e t o use a CW of 6 r a t h e r than 5 i n t h e above 
command. 


All you have t o do now i s s e t u p t h e c a r t r i d g e board f o r 
use 
on 
t h e C128. In order t o use a r e g u l a r C64 c a r t r i d g e board t o make a 
C128 c a r t r i d g e , y o u ' l l have t o make a couple minor 
modifications 
t o i t . Since board designs vary, d i f f e r e n t commercial boards 
may 
r e q u i r e d i f f e r e n t modifications. The following discussion a p p l i e s 
s p e c i f i c a l l y t o t h e PC2 c a r t r i d g e board 
a v a i l a b l e from 
CSM. 
A 
summary of t h e modifications y o u ' l l have t o make appears below i n 
f i g u r e 10-3. 


Figure 10-3: CHANGES TO PC2 FOR C128 CARTRIDGES 


1. Disconnect G A M E I E X R O M from ground ( c u t jumper A ) . 


2. Disconnect GAME and E X R O M from each o t h e r ( c u t jumper B ) . 


3. Disconnect pin 26 from pin 27 on each socket 
(underside of 
board). 


4. Connect halves of unlabeled jumper f o r 
pin 
26 
of 
HI 
ROM 
(from pin J of c a r t r i d g e connector). 


5. Connect pin 26 of one socket t o pin 26 of t h e 
o t h e r 
socket 
with a jumper wire. 


The f i r s t t h i n g you must do i s make s u r e t h e GAME'^^^ E X R O M l i n e s 
a r e not grounded by t h e board. I f t h e C128 P O L L r o u t i n e sees t h a t 
e i t h e r of t h e s e l i n e s a r e grounded, i t w i l l j u m p i n t o 
C64 
mode. 
To keep t h e s e l i n e s hi 
( n o t grounded), 
you 
must 
c u t 
through 
jumper A on t h e top s i d e ( E P R O M s i d e ) of t h e P C 2 board. This w i l l 
s e p a r a t e pins 8 & 9 of t h e c a r t r i d g e connector (GAME 
and 
E X R O M ) 
from t h e wide ground l i n e . 


On t h e C64, GAME and E X R O M a r e only capable of 
being 
i n p u t s 
t o 
t h e computer. O n t h e C128, t h e s e l i n e s 
a r e 
b i d i r e c t i o n a l , 
i . e . 


they can be used a s output l i n e s too. In f a c t , on 
t h e 
C128 sthe 


GAME l i n e has a dedicated use as an output l i n e , not 
r e l a t e d 
t o 
c a r t r i d g e s . To prevent p o s s i b l e 
i n t e r f e r e n c e , 
you 
should 
a l s o 
s e p a r a t e GAME and E X R O M from each o t h e r . 
This 
can 
be 
done 
by 
c u t t i n g jumper B on t h e PC2 board. 


,When a PC2 board i s used on t h e C64, 
each 
socket 
holds 
an 
8K 
EPROM (2764). O n t h e C128, each socket holds a 16K EPROM (27128). 
There a r e a couple changes t h a t m u s t be 
made 
t o t h e 
board 
i n 
order t o use 16K chips. Refer t o t h e appendix f o r t h e pinouts f o r 
a 27128 chip. F i r s t , l o c a t e p i n 26 of t h e HI 
ROM socket. This 
i s 
t h e LEFT socket of t h e two when t h e board i s r i g h t - s i d e u p ( E P R O M 
s i d e u p ) . Pin 26 i s t h e t h i r d pin from t h e TOP 
RIGHT 
corner 
of 
t h e 
socket 
( t h e top 
i s t h e 
end 
away 
from 
t h e 
c a r t r i d g e 
connector). P u t your f i n g e r by t h i s pin. Keeping t h e end with t h e 
c a r t r i d g e connector towards you, t u r n t h e board over. 
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On t h e bottom s i d e of t h e board, t h e HI 
ROM socket w i l l be on t h e 
RIGHT s i d e and pin 26 w i l l be t h e t h i r d pin 
from 
t h e 
t o p 
LEFT 
corner of t h e socket. Make s u r e you've got t h i s 
s t r a i g h t 
before 
you go any f u r t h e r . On t h e underside, 
pin 
26 
w i l l 
u s u a l l y 
be 
connected t o pin 27 (and pin 27 w i l l u s u a l l y be connected t o pin 
28). They may be connected by a drop of s o l d e r o r a s h o r t l i n e on 
t h e c i r c u i t board. Pin 26 i s n ' t used on 2764 (8K) c h i p s , 
b u t 
on 
27128 (16K) c h i p s 
i t ' s used 
f o r 
address 
l i n e 
13. 
You 
must 
disconnect pin 26 from pin 27 by 
c u t t i n g 
t h e 
c i r c u i t 
l i n e o r 
removing t h e drop of s o l d e r . You should leave pin 27 connected t o 
pin 28. Now follow t h e same procedure t o disconnect pins 
26 
and 
27 on t h e o t h e r socket ( L O R O M ) from each o t h e r . 


Next, l o c a t e t h e jumper pad t h a t i s connected t o pin 
26 
of 
t h e 
HI 
ROM socket by a s h o r t l i n e . The pad i s not labeled. 
There 
i s 
a l s o an unlabeled jumper pad connected t o p i n 27, 
so 
make 
s u r e 
you have t h e r i g h t one. The pad s e p a r a t e s pin 26 
of 
t h e 
socket 
from pin J of t h e c a r t r i d g e connector ( t h e 8 t h pin from t h e r i g h t 
on t h e underside of t h e connector). This jumper i s u s u a l l y 
open 
( c u t ) so t h e r e i s no connection between t h e 
two 
halves. 
Scrape 
t h e jumper pad clean of green s o l d e r mask. P u t a drop 
of 
s o l d e r 
on t h e jumper pad t o connect t h e two halves. This w i l l allow 
t h e 
e n t i r e 16K of memory i n t h e HI 
ROM t o be accessed. The 
ROM 
w i l l 
appear a t $C000-FFFF in memory ( h i space) when t h e c a r t r i d g e 
i s 
enabled. 


F i n a l l y , you have t o run a jumper wire from pin 26 of one 
socket 
t o pin 26 of t h e o t h e r socket. Use a 
s h o r t 
piece 
of 
i n s u l a t e d 
wire. Make s u r e t h a t t h e wire d o e s n ' t make c o n t a c t with any o t h e r 
pin on e i t h e r socket. We recommend t h a t you 
p u t your 
c a r t r i d g e 
board i n a p l a s t i c housing t o p r o t e c t i t once i t ' s f i n i s h e d . 


To f i n i s h u p our sample C128 c a r t r i d g e , simply i n s e r t 
t h e 
EPROM 
i n t o t h e RIGHT socket on t h e board. Make s u r e t h e 
notch 
on 
t h e 
chip matches t h e notch on t h e socket and a l l t h e pins a r e s t a r t e d 
in t h e i r holes before you press down on t h e 
EPROM. 
To 
t r y 
t h e 
c a r t r i d g e , power o f f t h e computer and i n s e r t 
t h e 
c a r t r i d g e . 
I f 
you have an expansion board, you might want t o plug i t i n 
f i r s t . 
W i t h t h e c a r t r i d g e s l o t on ( i f y o u ' r e using an expansion 
board), 
power u p t h e computer. You should see an i n t e r e s t i n g 
d i s p l a y 
on 
t h e screen (40 column screen o n l y ) . 
When 
you 
a r e 
returned 
t o 
BASIC, you might want t o experiment with t h e screen. Try 
loading 
a disk d i r e c t o r y and s e e what happens. 


Of course, t h i s l i t t l e demonstration c a r t r i d g e i s only 
a 
s t a r t , 
b u t with t h e information i n t h i s 
c h a p t e r 
you 
may 
be 
a b l e t o 
c r e a t e much more useful c a r t r i d g e s . We 
have t r i e d t o g i v e you a l l 
t h e e s s e n t i a l information on C128 c a r t r i d g e s i n t h i s chapter. The 
C128 i s a powerful and complex machine, so y o u ' l l need t o g e t 
t o 
know i t b e t t e r before you can program i t e f f e c t i v e l y . 
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8K BASIC CARTRIDGE 


Our f i r s t c a r t r i d g e u t i l i t y program i s a s i m p l e 
download-and-run 
r o u t i n e f o r BASIC programs. BASIC programs up t o 8K long 
can 
be 
put on c a r t r i d g e w i t h t h i s r o u t i n e . BASIC program s i z e i s l i m i t e d 
t o 8K s i n c e 16K c a r t r i d g e s 
r e p l a c e 
t h e 
BASIC 
ROM 
i n 
memory. 
Without 
t h e 
BASIC 
R O M , 
you 
c a n ' t 
r u n 
BASIC 
programs. 
The 
u t i l i t i e s f e a t u r e d i n l a t e r c h a p t e r s a l l o w you t o i n s t a l l 
l a r g e r 
programs on c a r t r i d g e i f you need t o , but 
t h e 
r o u t i n e 
i n t h i s 
c h a p t e r c a n ' t be b e a t f o r s i m p l i c i t y and e a s e of use. 


Thedownload 
r o u t i n e 
has 
two 
o p t i o n s . 
I f 
you 
a c t i v a t e 
t h e 
c a r t r i d g e through a RESET (power-up, RESET b u t t o n o r 
SYS 647381, 


t h e BASIC program w i l l be downloaded t o 
t h e 
normal 
BASIC 
a r e a 
( s t a r t i n g a t $0801) and R U N a u t o m a t i c a l l y . The 
o p e r a t i n g 
system 
and BASIC w i l l be c o m p l e t e l y i n i t i a l i z e d f i r s t , t o i n s u r e 
smooth 
o p e r a t i o n of t h e BASIC 
rogram. 
One 
s i d e - e f f e c t 
of 
t h e 
RESET 
o p t i o n t h a t you s h o u l d !e 
aware 
of 
i s t h a t 
t h e 
top-of-BASIC 
p o i n t e r MEMSIZ, l o c a t e d a t 643-644 ($0283-0284), w i l l be 
s e t 
t o 
32768 ($8000) r a t h e r t h a n 40960 ($A000). T h i s w i l l g i v e you 
l e s s 
f r e e s p a c e a v a i l a b l e f o r 
v a r i a b l e s 
t h a n 
normal. 
T h i s 
happens 
because t h e RAMTEST r o u t i n e , which s e t s up 
MEMSIZ, 
w i l l 
d e t e c t 
t h e end of RAM when i t r e a c h e s your c a r t r i d g e 
a t 
$8000, 
r a t h e r 
than when i t e n c o u n t e r s t h e BASIC ROM a t $A000. F o r t u n a t e l y , t h i s 
won't a f f e c t v e r y many 
BASIC 
programs 
u n l e s s 
t h e y 
use 
l a r g e 
a r r a y s o r l o t s of s t r i n g s . 
I f 
MEMSIZ 
y o u r 
BASIC 
program 
has 
t r o u b l e because of MEMSIZ, use t h e RESTORE key o p t i o n ( b e l o w ) . 


I f you use t h e RESTORE key r a t h e r 
t h a n 
RESET 
t o 
a c t i v a t e 
t h e 
c a r t r i d g e , t h e BASIC program w i l l be downloaded but w i l l 
n o t 
be 
R U N . T h i s way you can l i s t t h e program, modify i t , s a v e i t , 
e t c . 
You can u s e t h e R U N command t o e x e c u t e t h e program 
whenever 
you 


wan,t. Another f e a t u r e w i t h RESTORE i s t h a t t h e BASIC program w i l l 
be downloaded t o whatever a r e a i s c u r r e n t l y s e t f o r BASIC, 
which 
can be d i f f e r e n t from 
t h e 
normal 
BASIC 
a r e a . 
I f 
y o u r 
BASIC 
program must r e s i d e h i g h e r up i n memory t h a n normal, 
simply 
s e t 
t h e MEMSTR p o i n t e r a t 641-642 
($0281-82) 
t o 
t h e 
new 
l o c a t i o n 
b e f o r e you h i t RESTORE. Like a l l p o i n t e r s , MEMSTR i s s t o r e d 
w i t h 
t h e low o r d e r b y t e f i r s t and 
high 
o r d e r 
b y t e 
second 
( r e v e r s e 
o r d e r ) . For i n s t a n c e , i f you want t h e BASIC a r e a t o s t a r t a t 4096 
( $ 1 0 0 0 ) , t h e low b y t e would be 0 ( $ 0 0 ) and t h e high b y t e would be 
16 
( $ 1 0 ) . 
E n t e r 
P O K E 681,O 
and 
P O K E 682,16 
b e f o r e 
you 
h i t 
RESTORE. 


The RESTORE o p t i o n has one o t h e r f e a t u r e . S i n c e a 
RESET 
i s n o t 
performed, t h e top-of-BASIC p o i n t e r MEMSIZ w i l l be 
l e f t 
a t 
i t s 
c u r r e n t s e t t i n g ( s e e t h e RESET o p t i o n ) . I f you have an 
expansion 
board, you can s w i t c h on y o u r c a r t r i d g e , 
h i t 
RESTORE 
and 
then 
s w i t c h t h e c a r t r i d g e back 
o f f . 
The 
f u l l 
BASIC 
a r e a 
w i l l 
be 
a v a i l a b l e f o r v a r i a b l e s t h i s way. J u s t e n t e r R U N t o e x e c u t e 
t h e 
program. Note t h a t you MUST t u r n t h e c a r t r i d g e o f f a f t e r 
RESTORE 
because BASIC w i l l t r y t o use t h e c a r t r i d g e 
a r e a , 
s i n c e 
MEMSIZ 
i n d i c a t e s t h e a r e a i s a v a i l a b l e . 


EPROM H A N D B O O K 
8K BASIC CARTRIDGE 
P A G E 79 


S e t t i n g up a c a r t r i d g e w i t h t h e d o w n l o a d l r u n r o u t i n e 
i s s i m p l e . 
The p r o c e s s i s summarized i n f i g u r e 11-1. 


Figure 11-1: 8K B A S I C CARTRIDGE PROCEDURE 


1. Load i n t h e "8K BASIC" p r o g r a m a t $2000. 


2. 
Load i n y o u r BASIC p r o g r a m a t $2100. 


3. 
P u t t h e e n d i n g a d d r e s s o f 
t h e 
BASIC 
p r o g r a m 
i n t o 
t h e 
d o w n l o a d r o u t i n e . 


4. S e l e c t y o u r s c r e e n c o l o r s . 


5. Save t h e f i l e o u t t o d i s k i f d e s i r e d . 


6. Load PROMOS and b u r n t h e EPROM. 


7. 
I n s e r t t h e EPROM i n t o an 8K c a r t r i d g e board. 


Y o u ' l l need an ML m o n i t o r t o s e t up t h e 
c a r t r i d g e . 
MICROMON 
i s 
recommended because o f i t s r e l o c a t a b l e 
l o a d 
f e a t u r e . 
Load 
t h e 
m o n i t o r i n t o memory a t $C000. C l e a r t h e c a r t r i d g e a r e a b y f i l l i n g 
i t w i t h $ F F 8 s w i t h t h e f i l l command: 


U s i n g MICROMON, l o a d i n t h e f i l e "8K BASICn f r o m t h e p r o g r a m d i s k 
accompanying t h i s book: 


L "8K BASIC" 


The "8K BASIC" r o u t i n e 
w i l l 
l o a d 
i n a t 
$2000. 
A l t h o u g h 
t h e 
f i n i s h e d c a r t r i d g e w i l l r e s i d e a t $8000 i n memory, w e ' l l 
p u t i t 
t o g e t h e r a t $2000 t o make b u r n i n g i t o n t o EPROM more 
c o n v e n i e n t . 
Remember, u n l i k e a p r o g r a m f i l e , an EPROM has no 
i d e a 
where 
i n 
memory i t r e s i d e s . 
As 
e x p l a i n e d 
i n t h e 
c h a p t e r s 
on 
memory 
management and c a r t r i d g e b o a r d s , i t i s t h e PLA t h a t 
" t e l l s " 
t h e 
EPROM where i t i s i n memory. 


Your BASIC p r o g r a m m u s t now be l o a d e d i n s t a r t i n g a t 
$2100. 
Use 


MICROMON1s r e l o c a t a b l e l o a d command t o do t h i s : 


L 2100 " p r o g r a m name" 


Now y o u must t e l l t h e d o w n l o a d r o u t i n e where t h e end of t h e BASIC 
p r o g r a m i s (plus 1). 
T h i s i s easy because MICROMON a l w a y s r e p o r t s 
t h e e n d i n g a d d r e s s ( p l u s 1 ) o f t h e p r o g r a m a f t e r a l o a d . 
Make 
a 
n o t e o f t h e a d d r e s s g i v e n . S i n c e t h e BASIC p r o g r a m w i l l b e g i n 
a t 
$8100 i n t h e f i n i s h e d c a r t r i d g e r a t h e r t h a n $2100, y o u 
m u s t 
add 
$6000 t o t h e e n d i n g 
a d d r e s s 
g i v e n 
i n o r d e r 
t o t r a n s l a t e i t 
c o r r e c t l y . F o r i n s t a n c e , an e n d i n g a d d r e s s o f $2500 w o u l d 
become 
$8500, and an e n d i n g a d d r e s s o f 
$3500 
w o u l d 
become 
$9500. 
An 
e n d i n g a d d r e s s o v e r $4000 means t h e BASIC p r o g r a m i s t o o l a r g e t o 
f i t i n t h e c a r t r i d g e ! ( $ 4 0 0 0 i t s e l f i s a c c e p t a b l e ) . 
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Once you have t r a n s l a t e d t h e ending a d d r e s s , i t must be 
i n s e r t e d 
i n t o t h e download r o u t i n e a t l o c a t i o n s $2009-OA. Use t h e 
command 
M 2009 t o d i s p l a y t h i s s e c t i o n of memory. The ending a d d r e s s must 
3 
iven i n l o - b y t e l h i - b y t e o r d e r l i k e o t h e r p o i n t e r s . 
The 
a d d r e s s 
8500 would be s p e c i f i e d by p u t t i n g t h e low b y t e ( $ 0 0 ) 
a t 
$2009 
and t h e high b y t e ( $ 8 5 ) a t $200A. 


J u s t a f t e r t h e ending a d d r e s s p o i n t e r i n t h e download r o u t i n e a r e 
t h r e e c o l o r codes a t $200B-OD. These a r e t h e 
b o r d e r , 
background 
and t e x t 
c o l o r s , 
r e s p e c t i v e l y , 
t h a t 
w i l l 
be 
used 
when 
t h e 
c a r t r i d g e i s a c t i v a t e d . The d e f a u l t w i l l be w h i t e t e x t on an 
a l l 
black s c r e e n . I f you have your own p e r s o n a l f a v o r i t e c o l o r s 
(and 
who d o e s n ' t ? ) just f i l l them i n a t t h e 
same 
t i m e 
you 
s e t 
t h e 
ending a d d r e s s f o r t h e BASIC program. 


A t t h i s p o i n t t h e program i s ready t o burn o n t o 
EPROM. 
You 
may 
wish t o s a v e a copy t o d i s k f i r s t , a s a backup. Use t h e f o l l o w i n g 
MICROMON command: 


S "program", 2000, 4000 


To burn t h e program 
o n t o 
EPROM, 
e x i t 
MICROMON 
w i t h 
t h e 
" K " 
command. Load i n PROMOS from d i s k and r u n i t . Now e n t e r 
MICROMON 
again. You'll need t o i s s u e a PROMOS "Z" 
command 
t o 
i n i t i a l i z e 
t h e PROMENADE and e x t i n g u i s h t h e PGM and SKT l i g h t s . Now insert a 
2764 (8K) EPROM i n t o t h e PROMENADE w i t h t h e notch on t h e EPROM t o 
t h e l e f t . Lock down t h e handle on 
t h e 
ZIF 
s o c k e t . 
One 
simple 
command i s a l l you need t o burn t h e EPROM: 


Note: Do n o t t y p e t h e l e t t e r s " P I " - 
use 
t h e 
pi 
key 
on 
t h e 
keyboard. T h i s i s a s h i f t e d up-arrow ( n o t t h e c u r s o r up k e y ) . 
I t 
i s l o c a t e d n e x t t o t h e RESTORE key. All a d d r e s s e s f o r PROMOS must 
be given i n decimal: 8192 = $2000 and 16383 = $3FFF 


I t ' s a good i d e a t o r e a d t h e EPROM back i n now and compare i t t o 
t h e o r i g i n a l . Read t h e EPROM u s i n g : 


(16384 = $4000; 24575 = $5FFF). Compare t h e copy t o t h e o r i g i n a l : 


Assuming e v e r y t h i n g matches, y o u ' r e r e a d y t o mount t h e EPROM on a 
c a r t r i d g e board. Make s u r e t h e c a r t r i d g e board i s s e t 
up 
f o r 
a 
s t a n d a r d 8K c a r t r i d g e , w i t h t h e E X R O M l i n e a l o n e grounded. I n s e r t 
t h e EPROM i n t o t h e $8000-9FFF s o c k e t ( u s u a l l y t h e s o c k e t 
on 
t h e 
r i g h t i f t h e r e i s more t h a n o n e ) . The notch 
on 
t h e 
EPROM 
must 
c o r r e s p o n d t o t h e notch o r mark 
on 
t h e 
s o c k e t ! 
T u r n 
o f f 
t h e 
computer ( o r just t h e c a r t r i d g e s l o t i f 
you 
have 
an 
expansion 
b o a r d ) , plug i n t h e c a r t r i d g e , and t u r n i t back 
on. 
I f 
y o u ' v e 
done e v e r y t h i n g c o r r e c t l y , y o u r c a r t r i d g e should respond when you 
RESET o r use t h e RESTORE key. 


EPROM H A N D B O O K 
8K BASIC CARTRIDGE 
P A G E 81 


F i a u r e 11-2: 
8K BASIC DOWNLOADIRUN 


RESET Entry P o i n t 
., 
10 8L 16 D O STX $DO16 
., 8013 20 A3 FD JSR $FDA3 
., 8016 20 50 FD JSR $FD50 
., 8019 20 15 FD JSR $FD15 
., 801C 20 58 FF JSR $FF5B 
. , 801F 58 
CL I 
., 8020 A9 00 
L D A #$00 
., 8022 FO 02 
BEQ $8026 


RESTORE Entry P o i n t 


9 
2 4 A Y t-t 
LD'A #$FF 
., 8026 85 FD 
STA $FD 
., 8028 AD O B 80 LDA $8008 
., 8028 8D 20 D O STA $DO20 
., 802E AD OC 80 L D A $800C 
., 8031 8D 21 D O STA $DO21 
., 8034 AD O D 80 LDA $800D 
., 8037 8D 86 02 STA $0286 
., 803A 20 E7 FF JSR $FFE7 
., 803D 20 53 E4 JSR $E453 
., 8040 20 BF E3 JSR $E3BF 
., 8043 20 22 E4 JSR $E422 
., 8046 A9 00 
L D A #$00 
., 8048 85 FB 
STA $FB 
., 804A A9 81 
L D A #$81 
., 804C 85 FC 
STA $FC 
., 804E A5 2B 
L D A $28 
., 8050 85 2D 
STA $2D 
., 8052 A5 2C 
L D A $2C 
., 8054 85 2E 
STA $2E 
., 8056 A0 00 
L D Y #$00 
., 8058 B1 FB 
L D A ($FB),Y 
., 805A 91 2D 
STA ($2D),Y 
., 805C E6 FB 
I N C $FB 
., 805E D O 02 
BNE $8062 
., 8060 E6 FC 
INC $FC 
., 8062 E6 2D 
INC $2D 
., 8064 D O 02 
BNE $8068 
., 8066 E6 2E 
INC $2E 
., 8068 A5 FB 
L D A $FB 
., 806A CD 09 80 CMP $8009 
., 806D D O E9 
BNE $8058 
., 806F A5 FC 
LDA $FC 
., 8071 CD O A 80 CMP $800A 
., 8074 D O E2 
BNE $8058 


RESET. e n t r y = $8010 
RESTORE e n t r y = $8024 
CBM80 A u t o s t a r t key 
SET TO E N D OF SOURCE PROGRAM! 
C o l o r s - change i f d e s i r e d . 


T u r n on VIC 
IOINIT - i n i t I10 d e v i c e s 
RAMTAS - t e s t l i n i t RAM 
RESTOR - i n i t system v e c t o r s 
CINT - i n i t s c r e e n e d i t o r 
Enable IRQ i n t e r r u p t s 
S e t e n t r y f l a g - RESET 
S k i p n e x t s t a t e m e n t 


S e t e n t r y f l a g - RESTORE 
Save e n t r y method f l a g 


S e t b o r d e r c o l o r 


S e t background c o l o r 


S e t c h a r a c t e r c o l o r 
C L A L L - C l o s e a l l f i l e s 
I n i t BASIC v e c t o r s 
I n i t RAM f o r BASIC 
I n i t s c r e e n & do N E W 
I n i t s o u r c e p o i n t e r t o 
. 
s t a r t of BASIC program 
($FB-FC = $8100) 


I n i t d e s t i n a t i o n p o i n t e r 
t o s t a r t of BASIC a r e a 
($2D-2E = $2B-2C) 


C l e a r Y i n d e x r e g i s t e r 
Load n e x t s o u r c e b y t e 
and s a v e i n d e s t i n a t i o n 
Increment s o u r c e p o i n t e r 


Increment d e s t i n a t i o n 
p o i n t e r 


Compare s o u r c e p o i n t e r 
t o ending v a l u e . 
Continue a t $8058 
i f more t o do. 
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Fiaure 11-2: cont'd 


., 8076 A9 00 
L D A #$00 
C l e a r Z f l a g f o r next c a l l 
., 8078 20 71 A8 JSR $A871 
C L R - a d j u s t BASIC p o i n t e r s 
., 8078 20 33 A5 JSR $A533 
Re-link BASIC l i n e s 
., 807E A5 FD 
L D A $FD 
Check RESETIRESTORE f l a g 
., 8080 D O 03 
B N E $8085 
., 8082 4C AE A7 JMP $A7AE 
RESET - R U N program 
., 8085 4C 74 A4 JMP $A474 
RESTORE - R E A D Y mode 


F i g u r e 11-2 g i v e s a commented l i s t i n g of t h e 8K BASIC r o u t i n e . As 
explained i n t h e 
c h a p t e r 
on 
a u t o s t a r t 
c a r t r i d g e s , 
t h e 
CBM80 


a u t o s t a r t key a t $8004-08 c a u s e s t h e c a r t r i d g e t o be a c t i v a t e d on 
RESET o r RESTORE. The p o i n t e r s t o r e d a t 
$8000-01 
w i l l 
be 
used 
when a RESET i s done, and t h e p o i n t e r a t $8002-03 w i l l used 
when 
t h e RESTORE key i s p r e s s e d . Thus t h e RESET e n t r y p o i n t 
i s $8010 
and t h e RESTORE e n t r y p o i n t i s $8024. 


On RESET, t h e r o u t i n e performs t h e e x a c t same s e uence of 
e v e n t s 
t h a t would be done by t h e normal RESET r o u t i n e i ? t h e check f o r a 
CBM80 had f a i l e d . Compare t h e code a t $8010-IF w i t h t h e 
code 
i n 
t h e K E R N A L a t $FCEF-FE. T h i s code i n i t i a l i z e s t h e 110 c h i p s (VIC, 
SID & CIAs), system R A M , 
K E R N A L v e c t o r s and s c r e e n e d i t o r . 
Next, 
a s p e c i a l f l a g l o c a t i o n ($FD) i s s e t t o $00 t o i n d i c a t e t h a t 
t h e 
r o u t i n e was e n t e r e d through RESET. The r e s t of t h e 
RESET 
method 
i s i d e n t i c a l t o t h e RESTORE 
method, 
except 
t h e 
RESTORE 
e n t r y 
p o i n t i t s e l f i s skipped. 


When RESTORE i s p r e s s e d , t h e e n t r y method 
f l a g 
i s s e t 
t o $FF 
( t h i s s t a t e m e n t i s t h e only 
one 
skipped 
by 
RESET). 
Next 
t h e 
border, background and c h a r a c t e r c o l o r s a r e s e t from 
t h e 
v a l u e s 
you e n t e r e d . All open f i l e s a r e c l o s e d a s a p r e c a u t i o n , and 
then 
a f u l l BASIC i n i t i a l i z a t i o n i s done. This i s accomplished by 
t h e 
code a t $803D-45, which i n i t i a l i z e s t h e 
BASIC 
v e c t o r s 
and 
RAM 
v a r i a b l e s , p r i n t s t h e powerup s c r e e n and then does a N E W command. 


F i n a l l y we e n t e r t h e 
a c t u a l 
downloading 
phase. 
A 
p o i n t e r 
a t 


$FB-FC i s used t o keep t r a c k of t h e l o c a t i o n of t h e next b y t e 
t o 
be t r a n s f e r r e d from t h e c a r t r i d g e a r e a ( t h e s o u r c e ) . T h i s p o i n t e r 
i s i n i t i a l i z e d t o $8100, 
which 
i s where 
you 
put 
your 
BASIC 
program i n t h e c a r t r i d g e . A p o i n t e r a t $2D-2E keeps t r a c k of 
t h e 
l o c a t i o n of t h e next b y t e i n t h e BASIC 
a r e a 
( t h e d e s t i n a t i o n ) . 
T h i s p o i n t e r i s i n i t i a l i z e d t o t h e beginning of t h e c u r r e n t BASIC 
a r e a , which i s o b t a i n e d from t h e BASIC p o i n t e r 
TXTAB 
s t o r e d 
a t 


$2B-2C. The code a t $8056-67 t r a n s f e r s a 
b y t e 
from 
t h e 
source 
a r e a t o t h e d e s t i n a t i o n a r e a , and then increments t h e s o u r c e 
and 
d e s t i n a t i o n p o i n t e r s ( f i r s t t h e low byte i s incremented, and then 
t h e high b y t e i f n e c e s s a r y ) . Then t h e s o u r c e p o i n t e r 
i s checked 
a g a i n s t t h e ending v a l u e you put a t $8009-OA when 
you 
made 
t h e 
c a r t r i d g e . 
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When a l l t h e b y t e s have been t r a n s f e r r e d , t h e d e s t i n a t i o n p o i n t e r 
w i l l be l e f t p o i n t i n g t o t h e next byte p a s t t h e end of program i n 
t h e BASIC a r e a . The l o c a t i o n t h a t we chose t o s t o r e t h i s 
p o i n t e r 
i n , $2D-2E, i s c a l l e d VARTAB and i s used by BASIC t o i n d i c a t e t h e 
end of program t e x t p l u s 1 ( b e g i n n i n g of v a r i a b l e 
s t o r a g e ) . 
The 
v a l u e l e f t i n t h i s p o i n t e r 
w i l l 
be 
e x a c t l y 
c o r r e c t 
f o r your 
program t o o p e r a t e p r o p e r l y - t h a t ' s why we 
used 
t h i s 
p o i n t e r . 
All we have t o do i s c a l l 
t h e 
BASIC 
C L R 
command 
through 
t h e 
s u b r o u t i n e a t $A871 t o s e t t h e 
o t h e r 
BASIC 
p o i n t e r s 
based 
on 


VARTAB.Then 
we 
c a l l 
on 
a 
BASIC 
ROM 
r o u t i n e 
a t $A533 
t o 
r e c a l c u l a t e a l l t h e l i n k s 
i n your 
BASIC 
program. 
T h i s 
i s a 
p r e c a u t i o n t o e n s u r e t h a t t h e program w i l l 
r u n 
i n i t s c u r r e n t 
l o c a t i o n . 


F i n a l l y , we check t h e e n t r y method f l a g t h a t was s e t e a r l i e r . 
I f 
i t i s not $00, i t i n d i c a t e s t h a t t h e RESTORE e n t r y was 
used. 
In 
t h i s c a s e t h e r o u t i n e t e r m i n a t e s by jumping i n t o t h e BASIC 
READY 
mode loop a t $A474, which w a i t s f o r you t o e n t e r 
a 
command. 
I f 
t h e e n t r y method f l a g i s $00, i t i n d i c a t e s t h a t t h e 
RESET 
e n t r y 
was used. In t h i s c a s e t h e r o u t i n e t e r m i n a t e s by jumping 
t o t h e 
program execution 
loop 
a t $A7AE, 
which 
R U N S 
t h e 
downloaded 
program. 


Besides being used i n t h i s c a r t r i d g e , p a r t s 
of 
t h e 
r o u t i n e we 
have given you can be used i n o t h e r 
s i t u a t i o n s 
where 
you 
must 
i n i t i a l i z e t h e K E R N A L o r BASIC, 
o r 
run 
a BASIC 
program 
from 
machine language. You'll s e e s i m i l a r code i n some 
of 
our 
o t h e r 
c a r t r i d g e download r o u t i n e s . 
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Several readers called t o report 
a typo in the 
EPROM 
PROGRAMMERS 
HANDBOOK. In the f i r s t paragraph on p.85, we refer you t o the chapter on 
special cartridge hardware for instructions on 
making 
a cartridge 


svi tch. Unfortunately, there i s no such chapter! One was included i n the 
early stages of planning the book, 
b u t 
i t was 
dropped 
i n favor of 
concentrating on more software u t i l i t i e s . To 
install the switch we 
talked about, cut jlmrper pad A on the PC2 
board 
and 
scrape away the 
green solder mask. Connect a SPST switch across the two sides of the cut 
jumper pad. Note: this i s NOT a cartr~dge power switch. 
NEVER 
p l u g or 
u n p l u g a cartridge without switch~ng o f f the power (see PPM Vol. I ) . 


8K/16K CARTRIDGE MENU 


This chapter p r e s e n t s a menu program 
f o r 
standard 
8K 
and 
16K 
c a r t r i d g e s . These c a r t r i d g e s r e s i d e a t $8000-9FFF and $8000-BFFF, 
r e s p e c t i v e l y , i n computer memory and u s u a l l y use a "CBM8OU key a t 
$8000 t o a u t o s t a r t themselves. Both c a r t r i d g e s " r e p l a c e " t h e 
RAM 
a t $8000-9FFF, and a 16K c a r t r i d g e r e p l a c e s 
t h e 
BASIC 
ROM 
a t 


$A000-BFFF too. This normally 
l i m i t s 
t h e 
usefulness 
of 
t h e s e 
c a r t r i d g e s f o r s t o r i n g and downloading 
programs, 
especi a1 l y 
i n 
t h e case of BASIC programs with t h e 16K 
c a r t r i d g e . 
However, 
i f 
you have an expansion board such as t h e CSM S i n g l e S l o t o r C A R D C O 
5-Slot, you can download a program from c a r t r i d g e 
and 
then 
use 
your expansion board t o switch t h e c a r t r i d g e o f f . 
A 
switch 
can 
a l s o be mounted d i r e c t l y on t h e c a r t r i d g e f o r 
t h e 
same 
purpose 
( s e e t h e c h a p t e r on s p e c i a l c a r t r i d g e hardware). You'll need 
one 
of t h e s e a c c e s s o r i e s i n o r d e r t o use our 8K/16K menu. 


The menu program works very 
simply 
and 
conveniently. 
You 
may 
e n t e r t h e menu by 
doing 
a 
RESET 
(power-up, 
RESET 
button 
o r 
SYS 64738) o r by p r e s s i n g t h e RESTORE key. On power-up o r 
RESET, 
t h e computer i s completely i n i t i a l i z e d before beginning t h e menu 
screen. This 
i n c l u d e s 
i n i t i a l i z i n g 
BASIC. 
When 
t h e 
menu 
i s 
entered using t h e RESTORE key i n s t e a d , no i n i t i a l i z a t i o n i s done 
a t a l l , except t h a t which i s necessary t o d i s p l a y t h e menu on t h e 
screen and accept i n p u t ( K E R N A L r o u t i n e C L R C H N , 
$FFCC). 
Special 
c a r e was taken t o minimize t h e amount of memory d i s t u r b e d by 
t h e 
menu program. I f you e n t e r t h e menu and then 
change your 
mind, 
you can e x i t t o BASIC 
without 
downloading 
a 
program, 
without 
d i s t u r b i n g a BASIC program a l r e a d y i n 
memory 
and 
without 
even 


CLOSEing any f i l e s ! 


The menu program d i s p l a y s a 
menu 
screen 
and 
then 
i n p u t s 
an 
s e l e c t i o n number. You a r e l i m i t e d t o a maximum of 
10 
s e l e c t i o n s 
on t h e menu, numbered 0-9. Number 0 i s reserved f o r t h e " E x i t 
t o 
BASIC" s e l e c t i o n . You may have l e s s than 
10 
s e l e c t i o n s 
on 
t h e 
menu i f you wish. The program a u t o m a t i c a l l y checks 
f o r 
a 
v a l i d 
s e l e c t i o n number i n t h e c o r r e c t range. When a v a l i d s e l e c t i o n 
i s 
made, t h e corresponding f i l e i s downloaded 
t o 
RAM 
memory. 
The 
user i s then i n s t r u c t e d t o switch 
o f f 
t h e 
c a r t r i d g e 
and 
h i t 
R E T U R N . When R E T U R N i s pressed, t h e menu program checks 
t o make 
s u r e t h a t t h e c a r t r i d g e i s a c t u a l l y switched o f f before executing 
t h e downloaded program. 


Not only i s t h e menu program easy t o use, i t i s easy 
t o 
s e t 
u p 
too. The d i s k supplied with t h i s book c o n t a i n s a 
program 
c a l l e d 
"MENU MAKER". This BASIC program c r e a t e s 
a 
c a r t r i d g e f o r you, 
complete with menu and ready f o r burning onto EPROM! All you have 
t o do i s s p e c i f y t h e programs t o be 
p u t 
on 
t h e 
c a r t r i d g e 
and 
answer a few q u e s t i o n s about them. All necessary 
adjustments 
t o 
t h e menu program a r e made a u t o m a t i c a l l y and a simple menu 
screen 
i s c r e a t e d . The M E N U M A K E R program i s probably 
a l l 
y o u ' l l 
ever 
need t o s e t u p your own 8K o r 16K 
c a r t r i d g e s . 
We'll 
cover 
t h e 
i n n e r workings of t h e "bare" menu program a l i t t l e l a t e r , b u t f o r 
now, l e t ' s look a t how t o use M E N U M A K E R . 
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F i r s t , 
we 
recommend 
t h a t you 
c o l l e c t 
t o g e t h e r 
t h e 
d i s k s 
c o n t a i n i n g t h e programs you want t o p u t on 
t h e 
c a r t r i d g e . 
Note 
whether t h e program i s i n BASIC o r machine 
language 
( M L ) , 
and 
w r i t e down t h e SYS command used f o r each ML program. J o t down t h e 
s i z e of each program s o you can 
be 
s u r e 
t h e y ' l l 
f i t on 
y o u r 
c a r t r i d g e . 8K of c a r t r i d g e memory c o r r e s p o n d s t o a p p r o x i m a t e l y 32 
b l o c k s on d i s k , and 
16K 
c o r r e s p o n d s 
t o 64 
b l o c k s . 
The 
menu 
program o c c u p i e s 3 b l o c k s of memory, s o you have enough room l e f t 
on t h e c a r t r i d g e f o r t h e e q u i v a l e n t 
of 
29 
o r 
61 
d i s k 
b l o c k s 
r e s p e c t i v e l y . T h i s i s enough f o r a l a r g e BASIC o r ML program, 
o r 
s e v e r a l smalqer programs. I f you 
need 
more 
memory 
t h a n 
t h i s , 
y o u ' l l have t o u s e a bank-switch c a r t r i d g e , s i n c e 16K i s t h e most 
t h a t can be p u t on a s t a n d a r d c a r t r i d g e . 


Now l o a d i n t h e c a r t r i d g e maker program: L O A D "MENU M A K E R U , 8 ( t h e 
program o n l y works w i t h d e v i c e 8, d r i v e 0 ) . R U N i t . F i r s t you a r e 
asked i f t h i s i s an 8K o r 16K c a r t r i d g e . The n e x t t h r e e q u e s t i o n s 
ask you what c o l o r s s h o u l d be used f o r t h e b o r d e r , background and 
c h a r a c t e r s on t h e menu s c r e e n . C o l o r s a r e 
s p e c i f i e d 
by 
number, 
w i t h O=black, l = w h i t e and s o on ( s e e p . 139 
of 
t h e 
C64 
U s e r ' s 
Guide f o r a complete l i s t ) . Next, you a r e prompted f o r 
t h e 
M E N U 
TITLE. A maximum of 20 c h a r a c t e r s can be e n t e r e d f o r t h e 
t i t l e . 
You a r e l i m i t e d t o t h e u p p e r c a s e / g r a p h i c s c h a r a c t e r s e t f o r t h i s 
t i t l e and a l l 
o t h e r menu 
t e x t . 
The 
t i t l e w i l l 
be 
c e n t e r e d 
a u t o m a t i c a l l y and p r i n t e d a t t h e t o p of t h e menu s c r e e n when 
t h e 
c a r t r i d g e i s r u n . 


Now you must p r o v i d e some i n f o r m a t i o n a b o u t each 
program 
t o be 
p u t on t h e c a r t r i d g e . To h e l p you d e c i d e i f you have enough 
room 
l e f t f o r y o u r n e x t program, t h e number of b y t e s 
s t i l l 
a v a i l a b l e 
i n t h e c a r t r i d g e i s p r i n t e d o u t . I n s e r t t h e d i s k 
c o n t a i n i n g 
t h e 
f i r s t program f o r t h e c a r t r i d g e , and t y p e i n t h e 
program's 
f i l e 
name ( i t must be a PRG-type f i l e ) . The f i l e w i l l be 
loaded 
from 
t h e d i s k i n t o t h e a r e a where t h e c a r t r i d g e 
i s b e i n g 
assembled. 
I t s l o c a t i o n i n t h e c a r t r i d g e a r e a w i l l be r e c o r d e d i n a 
s p e c i a l 
download parameter t a b l e s o i t can be found l a t e r . I f you r u n o u t 
of room w h i l e l o a d i n g a f i l e , y o u ' l l 
be 
n o t i f i e d 
and 
g i v e n 
a 
chance t o l o a d i n a d i f f e r e n t f i l e ( o r q u i t ) . E r r o r s i n t h e 
l o a d 
p r o c e s s w i l l n o t a f f e c t t h e programs 
a l r e a d y 
i n s t a l l e d 
i n 
t h e 
c a r t r i d g e . By t h e way, i t ' s normal f o r t h e 
d r i v e 
t o s t a r t 
and 
s t o p d u r i n g t h e l o a d p r o c e s s . 
I t t a k e s 
a 
w h i l e , 
s o just 
be 
p a t i e n t . 


Next, you a r e asked i f t h i s i s a BASIC 
program. 
BASIC 
programs 
r e q u i r e a s p e c i a l boot r o u t i n e i n o r d e r t o R U N p r o p e r l y . The boot 
r o u t i n e i s m o d i f i e d t o s u i t y o u r program and t h e n t a c k e d 
on 
t h e 
end of t h e BASIC f i l e i n t h e c a r t r i d g e . 
I t w i l l 
be 
wiped 
o u t 
a f t e r y o u r BASIC program i s downloaded 
and 
R U N , 
s o i t won't 
i n t e r f e r e w i t h y o u r program a t a l l . BASIC programs MUST r e s i d e a t 
t h e 
normal 
s t a r t 
of 
BASIC 
f o r 
o u r 
boot 
t o work 
p r o p e r l y 


(2049=$0801). I f y o u r BASIC program r u n s 
h i g h e r 
u p 
i n 
memory, 
y o u ' l l have t o w r i t e y o u r own b o o t . Look a t o u r s 
t o s e e w h a t ' s 
i n v o l v e d . Tack y o u r boot on t h e end of t h e BASIC program 
ON 
THE 
DISK, answer NO t o t h e q u e s t i o n about b e i n g a BASIC program, 
and 
g i v e t h e l o c a t i o n of y o u r boot 
a s 
t h e 
e x e c u t i o n 
a d d r e s s 
( s e e 
below). 
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If your program i s i n machine language r a t h e r than BASIC, you a r e 
prompted f o r t h e EXECUTION ADDRESS. This i s t h e address t o JMP t o 
a f t e r t h e f i l e i s downloaded. The d e f a u l t value f o r t h e execution 
address i s t h e L O A D ADDRESS t h a t was found when t h e f i l e was read 
off disk. That i s , i f you d o n ' t e n t e r a value 
here 
t h e 
program 
will be executed a t i t s beginning 
byte. 
I f 
you 
want 
i t be 
executed a t some o t h e r l o c a t i o n , you must e n t e r t h e 
l o c a t i o n 
i n 
decimal. 


The l a s t prompt i s f o r t h e M E N U ENTRY. This i s t h e l i n e t h a t w i l l 
appear on t h e menu screen 
as 
t h e 
name 
of 
t h i s program. 
The 
maximum length f o r t h e menu e n t r y i s 16 c h a r a c t e r s . 
The 
d e f a u l t 
f o r t h i s e n t r y i s t h e filename from which t h e program was loaded. 
If you j u s t h i t R E T U R N t h a t ' s t h e name t h a t w i l l 
appear 
on 
t h e 
menu. 


A t t h i s point t h e f i r s t program has now 
been 
i n s t a l l e d 
i n 
t h e 
menu routine. The process r e p e a t s f o r each 
successive 
program, 
s t a r t i n g w i t h t h e bytes f r e e message and f i l e name 
prompt. 
When 
you a r e f i n i s h e d loading i n a l l t h e programs f o r t h i s c a r t r i d g e , 
press R E T U R N a t t h e filename prompt. The M E N U M A K E R program 
w i l l 
a l s o stop automatically a f t e r you reach program number 
9, 
s i n c e 
t h a t i s t h e highest number allowed. In e i t h e r case, a l l remaining 
bytes i n t h e 
c a r t r i d g e 
area w i l l 
be 
f i l l e d 
w i t h 
$FF1s f o r 
neatness. Then y o u ' l l be asked t o i n s e r t 
a 
disk 
and 
e n t e r 
a 
filename i n order t o save a copy of t h e c a r t r i d g e 
t o d i s k . 
You 
can a replace an e x i s t i n g f i l e by using "@O:" i n t h e name. I f you 
d o n ' t use "@0:", 
M E N U M A K E R 
w i l l 
n o t i f y you 
i f 
t h e r e 
i s a 
d u p l i c a t e name and o f f e r t o r e p l a c e t h e f i l e f o r you. Any 
e r r o r s 
t h a t occur i n t h e save process w i l l 
not 
d i s t u r b t h e 
c a r t r i d g e 
area i n memory. 


T h a t ' s a l l t h e r e i s t o i t . Your c a r t r i d g e i s now 
ready 
t o burn 
onto EPROM(s). I f you want 
t o prepare 
another 
c a r t r i d g e 
now, 
y o u ' l l have t o reload t h e M E N U MAKER program t o g e t a f r e s h blank 
menu. I f you want t o b u r n t h e 
c a r t r i d g e you've 
j u s t 
prepared, 
i t ' s s t i l l t h e r e i n memory. J u s t RESET t h e 
computer 
and 
y o u ' r e 
ready t o go ( t h e c a r t r i d g e r o u t i n e won't be a f f e c t e d ) . Of course, 
you can a l s o come back l a t e r and load 
t h e 
c a r t r i d g e 
f i l e from 
d i s k . Once you have your c a r t r i d g e r o u t i n e i n memory, load i n t h e 
PROMOS 
software 
from 
disk 
o r 
f l i p 
i n 
your 
PROMOS/HESMON 


c a r t r i d g e . E i t h e r 
form 
of 
PROMOS 
can 
be 
used 
s i n c e 
an 
8K 
c a r t r i d g e r o u t i n e r e s i d e s a t $2000-3FFF 
i n 
memory 
and 
a 
16K 
r e s i d e s a t $2000-5FFF. I f 
you 
must 
load 
i n your 
ML 
monitor 
s e p a r a t e l y from PROMOS, t h e best place f o r i t i n 
t h i s 
s i t u a t i o n 
i s a t $COO0 (49152), although both $1000 (4096) and $9000 (36864) 
a r e a l s o a v a i l a b l e . 


An 8K c a r t r i d g e r e q u i r e s one 
2764 
EPROM 
and 
a 
16K 
c a r t r i d g e 
r e q u i r e s two 
2764's. 
In 
e i t h e r 
c a s e , 
you 
a l s o 
need 
a 
PC2 
c a r t r i d g e board. I n s e r t an EPROM i n t o t h e PROMENADE (notch t o t h e 
l e f t ) and lock down t h e l e v e r . 8K c a r t r i d g e s 
and 
t h e 
f i r s t 8K 
s e c t i o n of 16K c a r t r i d g e s a r e s t o r e d a t $2000-3FFF by M E N U M A K E R , 
b u t we must s p e c i f y t h e s e addresses i n decimal 
f o r 
PROMOS. 
The 
complete PROMOS command t o burn t h e EPROM i s : 
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Note 
t h a t 
PI 
s t a n d s 
f o r t h e 
p i 
key 
on 
t h e 
k e y b o a r d 
( s h i f t u p - a r r o w ) , n o t t h e l e t t e r s P 
I . 
T h i s 
command 
u s e s 
t h e 
i n t e l l i g e n t 
programming 
method 
#1 
(PW=7), 
which 
i s a 
good 
compromise between s p e e d and 
r e l i a b i l i t y . 
After 
t h e 
EPROM 
i s 
programmed, i t i s good p r a c t i c e t o r e a d i t back t o make 
s u r e i t 
was programmed c o r r e c t l y . T h e r e 
i s 
room 
l e f t 
i n 
memory 
f r o m 
$6000-7FFF t o r e a d i n an 8K EPROM, s o use t h e command: 


Compare t h e c o p y w i t h t h e o r i g i n a l u s i n g 
t h e 
f o l l o w i n g 
command 
f r o m y o u r m o n i t o r : 


I f t h e r e a r e a n y d i f f e r e n c e s , d o u b l e - c h e c k y o u r commands and 
see 
t h e t r o u b l e s h o o t i n g s e c t i o n i n t h e a p p e n d i c e s . Assuming t h e EPROM 
was programmed c o r r e c t l y , remove i t f r o m t h e PROMENADE and 
l a b e l 
i t . I f you h a v e a 16K c a r t r i d g e , i n s e r t t h e s e c o n d EPROM and b u r n 
t h e r e s t of t h e c a r t r i d g e c o d e , l o c a t e d a t $4000-5FFF, u s i n g 
t h e 
command: 


Read t h e c o d e back i n u s i n g t h e f command a b o v e and compare i t t o 
t h e o r i g i n a l w i t h : 


B e f o r e you i n s t a l l t h e EPROM(s1 on t h e PC2 c a r t r i d g e 
b o a r d , 
you 
may h a v e t o d o a c o u p l e o f t h i n g s . 
F i r s t , 
we 
h i g h l y . recommend 
t h a t you i n s t a l l s o c k e t s 
on 
t h e 
b o a r d 
i f 
t h e y 
a r e n ' t 
t h e r e 
a l r e a d y . Be s u r e t o a l i g n t h e n o t c h o r d o t on t h e s o c k e t w i t h t h e 
c o r r e s p o n d i n g mark on t h e 
b o a r d 
f o r 
p i n 
1 . 
T h i s 
w i l l 
a v o i d 
c o n f u s i o n l a t e r and p o s s i b l e damage t o y o u r e q u i p m e n t s h o u l d 
you 
i n s e r t a n EPROM t h e wrong way. 


Next, you h a v e t o make 
s u r e 
t h a t 
t h e 
c a r t r i d g e 
g r o u n d s 
t h e 
c o r r e c t c o m b i n a t i o n o f t h e GAME and E X R O M 
l i n e s 
s o t h e 
p r o p e r 
memory c o n f i g u r a t i o n w i l l b e s e l e c t e d . GAME and E X R O M a r e p i n s 
8 
and 9 on t h e c a r t r i d g e b o a r d e d g e c o n n e c t o r ( n o t on t h e EPROMs!). 
F o r 16K c a r t r i d g e s , make s u r e t h e 
j u m p e r ( s ) 
on 
t h e 
b o a r d 
a r e 
c o n n e c t e d , n o t c u t s o t h e r e i s a c o n t i n u o u s p a t h f r o m e a c h p i n t o 
the w i d e g r o u n d l i n e on t h e b o a r d . F o r more d e t a i l e d 
i n f o r m a t i o n 
see t h e i n s t r u c t i o n s t h a t came w i t h y o u r PC2 b o a r d o r t h e p i n o u t s 
s e c t i o n i n t h e a p p e n d i c e s o f t h i s book. I f GAME and E X R O M a r e s e t 
c o r r e c t l y , b o t h LEDs ( l i g h t s ) w i l l come on when a 
16K 
c a r t r i d g e 
i s i n s e r t e d i n t o y o u r CSM S i n g l e S l o t o r C A R D C O 5 - S l o t 
e x p a n s i o n 
b o a r d . F o r 8K c a r t r i d g e s , you must c u t a jumper s o t h a t o n l y 
t h e 
EXROM l i n e ( p i n 9 ) i s g r o u n d e d . I f an 
8K 
c a r t r i d g e i s s e t 
up 
c o r r e c t l y , o n l y t h e r i g h t L E D w i l l l i g h t up when t h e c a r t r i d g e i s 
i n s e r t e d i n t o o n e o f t h e s e e x p a n s i o n b o a r d s . 
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All t h a t ' s l e f t i s t o mount t h e E P R O M ( s ) on t h e 
PC2 
b o a r d . 
The 
EPROM f o r an 8K c a r t r i d g e g o e s i n t h e r i g h t - h a n d 
s o c k e t 
of 
t h e 
board. F o r 16K c a r t r i d g e s , t h e f i r s t 
EPROM 
g o e s 
i n 
t h e 
r i g h t 
s o c k e t and t h e s e c o n d g o e s i n the l e f t . Make s u r e 
t h e 
n o t c h 
on 
t h e EPROM i s l i n e d up w i t h t h e n o t c h o r d o t on i t s s o c k e t . 
Your 
c a r t r i d g e i s r e a d y t o u s e ! P l u g i t i n t o y o u r e x p a n d e r b o a r d , f l i p 
i t on, and h i t RESET. You s h o u l d s e e y o u r b e a u t i f u l new menu 
and 
t h e prompt t o e n t e r y o u r s e l e c t i o n . V e r i f y t h a t t h e 
programs 
on 
t h e menu do i n d e e d r u n when s e l e c t e d . You may have t o u s e 
RESET 
r a t h e r t h a n RESTORE t o r e s t a r t t h e c a r t r i d g e a f t e r some 
programs 
have r u n . Have f u n ! 


Now l e t ' s t a k e a l o o k a t t h e i n n e r w o r k i n g s o f t h e 
menu 
program 
i t s e l f . T h i s i s t h e key r o u t i n e which M E N U M A K E R m o d i f i e s t o make 
i t s c a r t r i d g e s . I f you want t o c h a n g e t h e a p p e a r a n c e of t h e 
menu 
o r j u s t s e e how t h e r o u t i n e 
works, 
y o u ' v e 
come 
t o t h e 
r i g h t 
p l a c e . 


The " b a r e " 8K/16K M E N U r o u t i n e i s f o u n d i n t h e f i l e of 
t h e 
same 
name on t h e program d i s k . Load i t i n and l o o k 
a t i t w i t h 
y o u r 
m o n i t o r . I t n o r m a l l y r e s i d e s a t $8000 i n t h e computer. I t u s e s 
a 


"CBM801' c a r t r i d g e a u t o s t a r t key t o b o o t i t s e l f 
up 
on 
RESET 
o r 
RESTORE. On RESET ( c o l d - s t a r t ) t h e r o u t i n e 
s t a r t s e x e c u t i n g 
a t 
$8009, w h i l e on RESTORE ( w a r m - s t a r t ) i t b e g i n s a t $8044. 
I f 
you 
look a t the c o d e a t $8009, y o u ' l l s e e 
t h a t 
i t c a l l s 
t h e 
same 
i n i t i a l i z a t i o n r o u t i n e s n o r m a l l y performed on 
power-up 
(compare 
i t t o t h e 
" g e n e r i c " 
c o l d - s t a r t 
r o u t i n e 
i n t h e 
c h a p t e r 
on 
c a r t r i d g e i n t i a l i z a t i o n ) . The o n l y 
d i f f e r e n c e 
i s t h e 
c o d e 
a t 
$8013-17. T h i s c o d e s e t s t h e end of RAM 
p o i n t e r 
t o i t s normal 
s e t t i n g ($A000). This i s n e c e s s a r y s i n c e t h e 
RAM 
t e s t 
r o u t i n e 


(RAMTAS, $FD50) d e t e c t e d the c a r t r i d g e a t $8000 and set 
t h e 
end 
of RAM t h e r e i n s t e a d . 


S t a r t i n g a t $801F, 
t h e menu 
r o u t i n e 
a l s o 
p e r f o r m s 
a 
BASIC 
i n i t i a l i z a t i o n . 
T h i s 
i s 
p o s s i b l e 
s i n c e 
t h e 
main 
BASIC 
i n i t i a l i z a t i o n r o u t i n e s a r e a c t u a l l y i n t h e K E R N A L ROM! The 
o n l y 
e x c e p t i o n s a r e t h e s t a r t - u p s c r e e n 
p r i n t 
r o u t i n e 
and 
t h e 
N E W 
command. Both of t h e s e r o u t i n e r e s i d e i n t h e BASIC ROM. 
However, 
t h e BASIC ROM i s s w i t c h e d o f f when a 16K c a r t r i d g e i s plugged i n . 
We d o n ' t need t h e s t a r t - u p s c r e e n , b u t we do need 
t o do 
a 
N E W 
command. T h e r e f o r e we have w r i t t e n s p e c i a l c o d e t o p e r f o r m 
t h i s 
f u n c t i o n . You may f i n d t h e 
c o d e 
a t $801F-43 
u s e f u l 
i n 
o t h e r 
c a r t r i d g e s o r j u s t a s a c o n c i s e summary o f BASIC i n i t i a l i z a t i o n . 


The RESET p r o c e s s c o n t i n u e s i n t o t h e main 
menu 
code 
a t $8044. 
T h i s i s where t h e RESTORE e n t r y p o i n t i s t o o . The f i r s t t h i n g 
we 
do i s c a l l t h e C L R C H N ($FFCC) r o u t i n e t o a s s u r e u s 
t h a t 
we 
can 
w r i t e t o t h e s c r e e n and r e a d f r o m t h e keyboard. Next we 
s e t t h e 
b o r d e r and background c o l o r s . Then 
t h e 
menu 
s c r e e n 
i t s e l f 
i s 
p r i n t e d by a n i f t y s u b r o u t i n e a t $80BO. I f you want t o a l t e r 
t h e 
a p p e a r a n c e of t h e menu, 
y o u ' l l 
have 
t o u n d e r s t a n d 
what 
t h i s 
r o u t i n e d o e s . T h i s r o u t i n e c a n be v e r y u s e f u l i n 
o t h e r 
programs 
t o o . 
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The main p r o b l e m w i t h p r i n t i n g a n i c e - l o o k i n g menu 
i s t h a t 
t h e 
menu t e x t t a k e s up a l o t o f room i n t h e c a r t r i d g e . I n p a r t i c u l a r , 
c e n t e r i n g t h e menu on t h e s c r e e n r e q u i r e s a l o t o f spaces a t 
t h e 
b e g i n n i n g o f each l i n e . 
We 
can 
g e t 
around 
t h i s 
by 
u s i n g 
a 
much-neglected KERNAL 
r o u t i n e 
c a l l e d 
PLOT 
($FFFO). 
PLOT 
can 
e i t h e r r e a d t h e c u r r e n t c u r s o r p o s i t i o n o r move t h e c u r s o r 
t o 
a 
new p o s i t i o n . I n t h i s case 
we 
want 
t o 
move 
t h e 
c u r s o r . 
To 
i n d i c a t e t h i s we must c l e a r t h e c a r r y (CLC) and s e t 
up 
t h e 
new 
c u r s o r p o s i t i o n i n t h e X and Y r e g i s t e r s b e f o r e c a l l i n g PLOT. The 
row no. goes i n X and t h e column no. i n Y . 
Row 
and 
column 
a r e 
measured s t a r t i n g a t 0,O 
i n t h e upper 
l e f t - h a n d 
c o r n e r 
o f 
t h e 
screen. 


The p r i n t s u b r o u t i n e 
e x p e c t s 
i t s d a t a 
t o f o l l o w 
a 
s p e c i f i c 
f o r m a t . The f i r s t t w o 
c h a r a c t e r s a r e t h e r o w and column numbers, 
r e s p e c t i v e l y , f o r PLOT. Next comes t h e t e x t o f t h e s t r i n g 
t o 
be 
p r i n t e d . I t can be o f 
any 
l e n g t h 
and 
c o n t a i n 
any 
c h a r a c t e r s 
e x c e p t $00 b y t e s . The end o f t h e s t r i n g i s i n d i c a t e d 
b y 
a 
$00 
b y t e , w h i c h i s n o t p r i n t e d . A f t e r p r i n t i n g t h e f i r s t s t r i n g , 
t h e 
r o u t i n e w i l l a u t o m a t i c a l l y go on and p r i n t any o t h e r s t r i n g s t h a t 
f o l l o w t h e f i r s t i n memory. Each s t r i n g must obey t h e same f o r m a t 
as t h e f i r s t : PLOT r o w and column; 
s t r i n g 
t e x t ; 
$00 
b y t e . 
To 
t e r m i n a t e t h e p r i n t i n g p r o c e s s , y o u must p l a c e an $FF b y t e 
a f t e r 
t h e $00 b y t e o f t h e l a s t s t r i n g . $FF b y t e s i n t h e 
t e x t 
o f 
t h e 
s t r i n g a r e p r i n t e d n o r m a l l y ( i n case y o u want 
t o p r i n t 
t h e 
p i 
symbol, w h i c h i s $FF i n A S C I I ) . 


The e n t i r e menu s c r e e n i s p r i n t e d w i t h 
one 
c a l l 
t o t h e 
p r i n t 
r o u t i n e . A t $8051 i n t h e main menu r o u t i n e , we s e t up t h e X and Y 
r e g i s t e r s t o p o i n t t o t h e 
b e g i n n i n g 
o f 
t h e 
menu 
s c r e e n 
t e x t 
($8180). The low b y t e o f t h e address must be p u t 
i n X 
and 
t h e 
high b y t e i n Y . When we c a l l t h e p r i n t 
r o u t i n e , 
i t i m m e d i a t e l y 
s t o r e s t h i s p o i n t e r i n $0061 -62 (BASIC f l o a t i n g p o i n t a c c u m u l a t o r 
# I ) . Note t h a t t h e p r i n t r o u t i n e uses a s u b r o u t i n e 
a t 
$80DC 
t o 
i n c r e m e n t t h i s p o i n t e r as t h e s t r i n g i s processed. 
Y o u ' l l 
need 
t h i s l i t t l e s u b r o u t i n e i f y o u use 
t h e 
p r i n t 
r o u t i n e 
i n o t h e r 
programs. 


Back i n t h e main menu r o u t i n e , a f t e r 
p r i n t i n g t h e 
screen, 
t h e 
C H R I N r o u t i n e i s used a t $8058 t o i n p u t a s e l e c t i o n 
number 
f r o m 
t h e u s e r . T h i s KERNAL r o u t i n e c o n v e n i e n t l y h a n d l e s a l l t h e c u r s o r 
movement, INST/DEL, 
RETURN, e t c . k e y s f o r us. The FIRST c h a r a c t e r 
t y p e d by t h e u s e r i s r e t u r n e d i n t h e a c c u m u l a t o r 
when 
t h e 
u s e r 
p r e s s e s RETURN ( t h i s means "01" i s i n t e r p r e t e d as " 0 " ) . 
Then 
t h e 
c h a r a c t e r e n t e r e d i s checked 
a g a i n s t 
t h e 
r a n g e 
o f 
a l l o w a b l e 
v a l u e s . F i r s t t h e c h a r a c t e r i s e x c l u s i v e - o r ' e d 
w i t h 
t h e 
v a l u e 
$30. T h i s c o n v e r t s t h e h i g h n y b b l e i n t o a 0 i f and ONLY i f i t was 
a 3 o r i g i n a l l y , i 
.e. i t c o n v e r t s 
v a l u e s 
i n t h e 
r a n g e 
$30-39 
(ASCII " 0 " - " 9 " ) 
t o $00-09. 
The r e s u l t i s compared w i t h t h e 
v a l u e 
i n l o c a t i o n $80FE. T h i s l o c a t i o n c o n t a i n s t h e 
h i g h e s t 
s e l e c t i o n 
number a l l o w e d , PLUS 1. O n l y s e l e c t i o n s i n t h e r a n g e f r o m $00 
up 
t o b u t n o t i n c l u d i n g t h i s v a l u e a r e a l l o w e d . 
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Once an a l l o w a b l e s e l e c t i o n i s made, i t i s pushed o n t o t h e 
s t a c k 
t o save i t t e m p o r a r i l y . Next, a r o u t i n e a t 
$8076 
i s c a l l e d 
t o 
download a s p e c i a l r o u t i n e t o RAM a t $02A7. 
Then 
t h e 
s e l e c t i o n 
number i s p u l l e d back o f f t h e s t a c k and t h e s e l e c t e d 
program 
i s 
downloaded t o RAM u s i n g t h e 
$8076 
r o u t i n e . 
F i n a l l y , 
t h e 
menu 
program ends by j u m p i n g t o $02A7, t h e s p e c i a l RAM 
r o u t i n e . 
T h i s 
r o u t i n e i s v e r y i m p o r t a n t and r e q u i r e s a b i t o f 
e x p l a n a t i o n . 
We 
c a n ' t j u s t jump 
t o 
t h e 
s e l e c t e d 
program 
as 
soon 
as 
i t i s 
downloaded. W h i l e t h i s would be okay 
f o r 
some 
programs, 
o t h e r 
programs may 
need 
t h e 
B A S I C 
ROM 
o r 
t h e 
RAM 
a t 
$8000-9FFF 


a v a i l a b l e . I n g e n e r a l , 
we 
want 
t o 
l e t t h e 
u s e r 
s w i t c h 
t h e 
c a r t r i d g e o f f b e f o r e t h e program i s executed. T h i s i s "poor man's 
b a n k - s w i t c h i n g " - i t l e t s us use t h e much l e s s e x p e n s i v e s t a n d a r d 
c a r t r i d g e s 
where 
we 
m i g h t 
o t h e r w i s e 
need 
a 
b a n k - s w i t c h e d 
c a r t r i d g e . O f course, y o u need a 
c a r t r i d g e 
e x p a n s i o n 
b o a r d 
o r 
e q u i v a l e n t t o s w i t c h o f f t h e c a r t r i d g e , b u t you s h o u l d 
have 
one 
anyway i f y o u ' r e w o r k i n g w i t h c a r t r i d g e s . 


The s p e c i a l r o u t i n e a t $02A7 g i v e s t h e u s e r a chance t o t u r n 
o f f 
t h e c a r t r i d g e . T h i s r o u t i n e w a i t s f o r t h e 
u s e r 
t o 
h i t RETURN, 
checks t h a t t h e c a r t r i d g e i s a c t u a l l y o f f , and t h e n e x e c u t e s 
t h e 
downloaded program. The s p e c i a l r o u t i n e must be i n RAM 
s i n c e i t 
has t o f u n c t i o n a f t e r t h e c a r t r i d g e has been 
t u r n e d 
o f f . 
Also, 
t h e r o u t i n e must be m o d i f i e d each t i m e so i t w i l l 
jump 
t o t h e 
c o r r e c t address f o r t h e p a r t i c u l a r program t h a t 
was 
downloaded. 
The download r o u t i n e a t 
$8076 
i s used 
once 
t o 
i n s t a l l 
t h i s 
s p e c i a l r o u t i n e i n RAM and t h e n a g a i n t o 
download 
t h e 
s e l e c t e d 
program. The download r o u t i n e a u t o m a t i c a l l y i n s e r t s t h e e x e c u t i o n 
address f o r t h e downloaded program i n t o t h e s p e c i a l RAM r o u t i n e . 


The download r o u t i n e 
g e t s 
i t s i n f o r m a t i o n 
f r o m 
t h e 
DOWNLOAD 
PARAMETER TABLE a t 8100. Each menu s e l e c t i o n has an e n t r y i n t h i s 
t a b l e . Each e n t r y c o n s i s t s o f 4 t w o - b y t e p o i n t e r s , each s t o r e d i n 
s t a n d a r d l o - b y t e / h i - b y t e o r d e r . The f i r s t 
p o i n t e r 
o f 
an 
e n t r y 
i n d i c a t e s t h e s t a r t i n g l o c a t i o n o f t h e 
s e l e c t e d 
program 
w i t h i n 
t h e 16K c a r t r i d g e area, and 
t h e 
second 
p o i n t e r 
i n d i c a t e s 
t h e 
e n d i n g l o c a t i o n w i t h i n t h e c a r t r i d g e p l u s 1. 
The 
t h i r d 
p o i n t e r 
i n d i c a t e s where t h e program n o r m a l l y r e s i d e s i n memory, i.e., 
t h e 
s t a r t o f t h e a r e a t o download t h e program t o . The l a s t p o i n t e r i s 
t h e e x e c u t i o n address. The download r o u t i n e a u t o m a t i c a l l y i n s e r t s 
t h i s address i n t o t h e s p e c i a l RAM r o u t i n e a t $02CO-C1, 
where 
i t 
i s used e v e n t u a l l y t o s t a r t t h e downloaded program. 
To 
use 
t h e 
download r o u t i n e , y o u s i m p l y p u t 
t h e 
s e l e c t i o n 
number 
i n t h e 
accumulator and c a l l t h e r o u t i n e . It p i c k s o u t t h e c o r r e c t 
e n t r y 
f r o m t h e download t a b l e and does t h e r e s t . 


Out o f a l l t h i s , t h e r e a r e o n l y a c o u p l e t h i n g s you need t o 
know 
if y o u 
want 
t o 
s e t 
up 
c a r t r i d g e s 
y o u r s e l f 
w i t h 
t h e 
b a r e 


"8K/16K MENU" program r a t h e r t h a n use t h e 
"MENU MAKER" 
program. 
Unless y o u want t o u n d e r t a k e m a j o r s u r g e r y on t h e 
menu 
program, 
about a l l you can do e a s i l y i s change t h e appearance o f t h e menu. 
O f course, y o u ' l l a l s o have t o s e t up t h e o t h e r f u n c t i o n s o f 
t h e 
menu program c o r r r e c t l y . H e r e ' s a c h e c k l i s t o f t h e s t e p s y o u have 
t o t a k e t o s e t up a c a r t r i d g e : 
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1 ) C o l l e c t t h e programs y o u w i s h t o p u t 
on 
c a r t r i d g e . 
W r i t e 
down t h e number o f b y t e s each r e q u i r e s . 


2 ) Load i n y o u r 
m o n i t o r . 
Micromon 
i s recommended 
f o r 
i t s 
a b i l i t y t o l o a d a f i l e i n t o any 
a r e a 
o f 
memory. 
We 
a l s o 
recommend t h a t y o u l o c a t e i t o u t o f t h e way up a t $C000. 


3 ) Load t h e "8K/16K MENU" program i n t o a s u i t a b l e area, such as 
$2000. 


4 ) Design a menu s c r e e n and s t o r e i t i n t o 
t h e 
menu 
program 
s t a r t i n g 
a t 
$8180 
( o r 
$2180 
i f y o u ' r e 
assembling 
t h e 
c a r t r i d g e a t $2000). Remember t h a t each s t r i n g t o be p r i n t e d 
must be preceded by t h e row and column number f o r PLOT, 
and 
f o l l o w e d by a $00 b y t e . P u t an $FF b y t e a f t e r t h e $00 o f t h e 
l a s t s t r i n g . You must s e t up y o u r menu f i r s t so y o u ' l l 
know 
where 
y o u 
can 
s t a r t 
s t o r i n g 
t h e 
programs 
w i t h i n 
t h e 
c a r t r i d g e . 


5 ) Record t h e number o f c h o i c e s t h a t 
w i l l 
be 
on 
y o u r 
menu, 
PLUS 1. T h i s v a l u e n o r m a l l y goes a t 
$80FE, 
b u t i f y o u ' r e 
assembling y o u r c a r t r i d g e a t $2000 
t h e n 
t h e 
c o r r e s p o n d i n g 
address i s $20FE. 


6 ) F i l l t h e c a r t r i d g e a r e a w i t h $FF b y t e s . 


7 ) Load each program i n t o t h e c a r t r i d g e area, one by 
one. 
J o t 
down t h e s t a r t i n g and e n d i n g addresses o f 
each 
program 
i n 
t h e c a r t r i d g e , 
and 
a l s o 
i t s normal 
l o a d 
and 
e x e c u t i o n 
addresses. I f you have room, you m i g h t want 
t o 
s t a r t 
each 
program a t t h e b e g i n n i n g o f a page (e.g. 
$8500) r a t h e r 
t h a n 
cramming them a l l t o g e t h e r as t h e MENU MAKER program does. 


8 ) I f y o u a r e u s i n g any B A S I C programs, y o u ' l l have t o t a c k t h e 
B A S I C b o o t r o u t i n e f r o m MENU MAKER on 
t h e 
end. 
Examine 
a 
c a r t r i d g e p r e p a r e d by MENU MAKER t o see how t h e 
B A S I C 
b o o t 
r o u t i n e i s m o d i f i e d f o r a p a r t i c u l a r program. Then make 
t h e 
c o r r e s p o n d i n g changes f o r y o u r program. The l o c a t i o n o f 
t h e 
B A S I C b o o t r o u t i n e s h o u l d be used as t h e 
e x e c u t i o n 
address 
o f t h e B A S I C program. D o n ' t f o r g e t t o c o u n t t h e b o o t r o u t i n e 
when d e t e r m i n i n g t h e e n d i n g address o f t h e 
program 
i n t h e 
c a r t r i d g e . 


9 ) When a l l t h e programs have been l o a d e d 
i n t o 
t h e 
c a r t r i d g e 
area, f i l l i n t h e download t a b l e 
w i t h 
t h e 
parameters 
f o r 
each program. Remember t o ADD 1 t o t h e e n d i n g address w i t h i n 
t h e c a r t r i d g e f o r each program. 


1 0 ) T h a t ' s i t - save t h e 
c a r t r i d g e 
f i l e t o d i s k . F o l l o w 
t h e 
d i r e c t i o n s above f o r b u r n i n g t h e EPROMs and s e t t i n g 
up 
t h e 
c a r t r i d g e board. 


We hope you have a l o t o f f u n w i t h t h e menu u t i l i t i e s f r o m 
t h i s 
c h a p t e r . We want y o u t o g e t t h e most f r o m y o u r PROMENADE, 
and 
we 
hope t h e y h e l p you do it. 
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DOWNLOAD/RUN ROUTINE 


The p r o g r a m d i s k w i t h t h i s b o o k i n c l u d e s a 
s p e c i a l 
DOWNLOAD/RUN 


r o u t i n e , c o u r t e s y o f J a s o n - R a n h e i m . 
The r o u t i n e i s a l s o 
i n c l u d e d 
on t h e PROMOS d i s k s u p p l i e d w i t h t h e PROMENADE. The 
DOWNLOAD/RUN 


r o u t i n e (DL/RUN f o r s h o r t ) i s f o r u s e w i t h 
t h e 
PC4 
b a n k - s w i t c h 
c a r t r i d g e , a v a i l a b l e f r o m CSM. 
The PC4 a l l o w s y o u t o p u t up t o 4 
EPROMs o n one b o a r d , w i t h e a c h EPROM a l l o w e d t o b e u p t o 
64K 
i n 
s i z e . T h i s g i v e s y o u a p o t e n t i a l o f 256K o n a c a r t r i d g e t h e 
s i z e 
of a s t a n d a r d game c a r t r i d g e ! ( i t e v e n f i t s i n a s t a n d a r d c a s e ) . 


The DL/RUN r o u t i n e l e t s y o u p u t a BASIC p r o g r a m u p t o 38K l o n g on 
a PC4 b o a r d . The 38K l i m i t i s t h e maximum s i z e f o r BASIC p r o g r a m s 
o n t h e C64. B e s i d e s BASIC p r o g r a m s , t h i s r o u t i n e c a n b e u s e d w i t h 
any m a c h i n e l a n g u a g e p r o g r a m t h a t r e s i d e s i n t h e BASIC 
a r e a 
and 
h a s a BASIC b o o t s t a t e m e n t a t t h e b e g i n n i n g ( s u c h 
as 
SYS 2 0 6 1 ) . 
When y o u RESET o r p o w e r u p t h e c o m p u t e r , t h e c a r t r i d g e w i l l s t a r t 
i t s e l f 
a u t o m a t i c a l l y . 
The 
DL/RUN 
r o u t i n e 
w i l l 
d o w n l o a d 
t h e 
p r o g r a m f r o m t h e c a r t r i d g e i n t o t h e BASIC a r e a . Then t h e 
r o u t i n e 
w i l l 
s w i t c h 
o f f 
t h e 
c a r t r i d g e , 
u s i n g 
t h e 
P C 4 ' s 
i n t e r n a l 
b a n k - s w i t c h r e g i s t e r (BSR). T h i s a l l o w s t h e 8K o f RAM 
u n d e r 
t h e 
c a r t r i d g e t o b e u s e d b y t h e p r o g r a m , i f r e q u i r e d . 
F i n a l l y , 
t h e 
p r o g r a m w i l l b e e x e c u t e d w i t h a BASIC RUN command. 


To s e t u p a c a r t r i d g e w i t h t h e DL/RUN 
r o u t i n e , 
y o u 
m u s t 
f i r s t 
d e t e r m i n e r o u g h l y how l o n g y o u r p r o g r a m i s . A g o o d 
e s t i m a t e 
c a n 
b e o b t a i n e d b y t a k i n g t h e 
number 
o f 
d i s k 
b l o c k s 
t h e 
p r o g r a m 
o c c u p i e s and d i v i d i n g i t b y 4. T h i s w i l l g i v e y o u t h e a p p r o x i m a t e 
s i z e o f t h e p r o g r a m i n K ( 1 K = 1 0 2 4 b y t e s = 4 d i s k b l o c k s ) . U s i n g 
t h i s f i g u r e , y o u c a n c h o o s e t h e s i z e a n d number o f EPROMs 
y o u ' l l 
need. The DL/RUN r o u t i n e a l l o w s y o u u s e a n y 
c o m b i n a t i o n 
o f 
t h e 
f o l l o w i n g c h i p s t o p r o v i d e t h e amount o f memory y o u n e e d : 


CHIP 
S I Z E 


F o r i n s t a n c e , i f y o u r 
p r o g r a m 
i s 21K 
l o n g 
( a p p r o x . 
8 4 
d i s k 
b l o c k s ) y o u c o u l d u s e j u s t o n e 32K c h i p , o r o n e 16K c h i p and 
one 
8K c h i p , o r t h r e e 8K c h i p s . 


Once y o u ' v e s e l e c t e d t h e c h i p s , y o u n e e d t o l o a d PROMOS. I f y o u r 
BASIC p r o g r a m i s l e s s t h a n 30K ( 1 2 1 d i s k b l o c k s ) , y o u c a n u s e t h e 
PROMOS/HESMON c a r t r i d g e ( a v a i l a b l e f r o m CSM). I f y o u 
a r e 
u s i n g 
t h e c a r t r i d g e , s k i p t h e f o l l o w i n g d i r e c t i o n s o n 
l o a d i n g 
PROMOS. 
J u s t i n s e r t y o u r c a r t r i d g e , p o w e r u p and e n t e r PROMOS w i t h 


SYS 9*4096 
( o r SYS 3 6 8 6 4 ) 
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I f y o u d o n ' t have a PROMOS c a r t r i d g e o r y o u r 
p r o g r a m 
i s l o n g e r 
t h a n 30K, y o u w i l l have t o u s e t h e d i s k v e r s i o n o f 
PROMOS. 
T h i s 
v e r s i o n a u t o m a t i c a l l y c o p i e s i t s e l f up t o t h e end 
o f 
t h e 
BASIC 
a r e a when y o u r u n it. I n o u r s i t u a t i o n , we want t o p u t PROMOS 
up 
a t t h e end o f t h e $C000-CFFF a r e a t o g e t i t o u t o f 
t h e 
way. 
We 
c a n f o o l PROMOS i n t o r e l o c a t i n g i t s e l f up t h e r e i f we t e m p o r a r i l y 
change t h e 
end 
o f 
B A S I C 
p o i n t e r 
s t o r e d 
i n l o c a t i o n s 
55-56 


( $ 3 7 - 3 8 ) . 
F i r s t l o a d i n PROMOS f r o m d i s k , b u t DON'T r u n i t y e t . 


N e x t , change t h e end o f B A S I C p o i n t e r : 


POKE 55, 0 
(RETURN) 
POKE 56, 208 
(RETURN) 


T h i s s e t s t h e end o f t h e B A S I C a r e a t o $DO00 ( 2 0 8 = $DO). Now r u n 
PROMOS: 


RUN 


You s h o u l d see t h e PROMOS s t a r t u p message appear. N e x t we h a v e t o 
s e t t h e end o f BASIC a r e a b a c k t o i t s n o r m a l 
p o s i t i o n 
a t 
$A000 


($A0 = 1 6 0 ) : 


POKE 55, 0 
POKE 56, 
160 


Once PROMOS i s r e a d y ( d i s k o r c a r t r i d g e 
v e r s i o n ) , 
y o u 
need 
t o 
l o a d i n t h e DL/RUN r o u t i n e . I n s e r t 
t h e 
p r o g r a m 
d i s k 
i n t o t h e 
d r i v e and t y p e 


LOAD "DOWNLOAD/RUN", 
8, 1 


The r o u t i n e w i l l l o a d i n a t $COO0 ( 4 9 1 5 2 ) . 
To 
r e s e t 
t h e 
BASIC 
p o i n t e r s and a v o i d "OUT OF MEMORY" e r r o r s i n t h e n e x t s t e p s , 
y o u 
must do a BASIC NEW command: 


NEW 


Now y o u ' r e r e a d y f o r t h e BASIC program. 
I n s e r t t h e d i s k and 
l o a d 
t h e p r o g r a m i n as u s u a l : 


LOAD " p r o g r a m " , 8 


The DL/RUN r o u t i n e needs t o know 
where 
t h e 
end 
o f 
t h e 
BASIC 
p r o g r a m i s s o i t c a n t e l l when t o s t o p 
d o w n l o a d i n g 
t h e 
p r o g r a m 
f r o m t h e c a r t r i d g e . A f t e r a l o a d , BASIC a u t o m a t i c a l l y s e t s 
up 
a 
p o i n t e r t o i n d i c a t e t h e end 
o f 
t h e 
p r o g r a m . 
T h i s 
p o i n t e r 
i s 
s t o r e d a t 45-46 ($2D-2E). 
W e ' l l t a k e t h e i n f o r m a t i o n s t o r e d t h e r e 
and pass i t a l o n g t o t h e DL/RUN r o u t i n e : 


POKE 49161, PEEK(45) 
POKE 49162, 
PEEK(46) 
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You must use t h e p r o p e r CW and PMW, 
as g i v e n i n t h e c h a r t 
above. 
You must a l s o s u b s t i t u t e a d i f f e r e n t number f o r 
A A A A A 
a c c o r d i n g 
t o t h e f o l l o w i n g c h a r t : 


CHIP 
A A A A A 
BYTES 


T h i s command w i l l c o m p l e t e l y f i l l t h e f i r s t EPROM. Remove i t from 
t h e PROMENADE and l a b e l i t so i t w o n ' t 
g e t 
m i x e d 
up 
w i t h 
any 
o t h e r c h i p s . 


From y o u r i n i t i a l e s t i m a t e of t h e s i z e o f 
t h e 
p r o g r a m 
i n d i s k 
b l o c k s o r K, y o u s h o u l d know how many c h i p s y o u have l e f t 
t o 
do 
( i f a n y ) . You c a n t e l l 
more 
e x a c t l y 
b y 
u s i n g 
t h e 
v a l u e 
y o u 
c a l c u l a t e d e a r l i e r f o r t h e end o f t h e 
BASIC 
p r o g r a m 
( f r o m 
t h e 
p o i n t e r a t 4 5 - 4 6 ) . I f t h e number g i v e n f o r AAAAA i s g r e a t e r 
t h a n 
o r e q u a l t o t h e end o f t h e BASIC program, 
y o u ' r e 
done 
a l r e a d y ! 
Your f i r s t c h i p was l a r g e enough t o h o l d t h e w h o l e program. 


I f t h e e n t i r e B A S I C p r o g r a m d i d NOT f i t on y o u r f i r s t c h i p , 
t h e n 
y o u ' l l need t o c o n t i n u e b u r n i n g t h e p r o g r a m o n t o a 
second 
c h i p . 
You must s t a r t programming t h e second c h i p from t h e same p o i n t i n 
t h e BASIC p r o g r a m t h a t y o u l e f t o f f a t i n t h e f i r s t c h i p . Use t h e 
f o l l o w i n g command: 


P I AAAAA+l, 
B B B B B , 0, 
CW, 
PMW 


You must f i l l i n t h e c o r r e c t v a l u e s f o r A A A A A + l 
and 
B B B B B . 
The 
v a l u e f o r A A A A A + l i s f o u n d b y a d d i n g 1 t o t h e v a l u e y o u u s e d 
f o r 
AAAAA i n t h e p r e v i o u s command ( a s i f y o u 
h a d n ' t 
g u e s s e d ) . 
The 
v a l u e f o r B B B B B i s c a l c u l a t e d b y a d d i n g t h e s i z e 
o f 
t h e 
SECOND 
c h i p i n BYTES t o t h e number y o u u s e d f o r A A A A A 
i n t h e 
p r e v i o u s 
command. The s i z e o f t h e d i f f e r e n t t y p e s o f 
c h i p s 
i n b y t e s 
i s 
g i v e n i n t h e c h a r t above. 
O f c o u r s e , y o u a l s o have t o f i l l i n t h e 
c o r r e c t v a l u e s f o r t h e CW and PMW based on t h e t y p e of t h e second 
c h i p . 


Once a g a i n , i f t h e number y o u u s e d f o r B B B B B i s g r e a t e r 
t h a n 
o r 
e q u a l t o t h e end 
o f 
t h e 
B A S I C 
p r o g r a m 
( f r o m 
45-46), 
y o u ' r e 
f i n i s h e d . I f t h e r e i s more t o do, j u s t c o n t i n u e t h e p r o c e s s . 
The 
t h i r d c h i p w i l l r e q u i r e t h e command: 


P I BBBBB+l, 
C C C C C , 
0, 
CW, 
PMW 


C C C C C i s c a l c u l a t e d b y a d d i n g t h e s i z e o f t h e THIRD c h i p i n b y t e s 
t o t h e v a l u e y o u u s e d f o r BBBBB. I f a f o u r t h 
c h i p 
i s r e q u i r e d , 
use: 


P I C C C C C + l , 
DDDDD, 
0, 
CW, 
PMW 


By t h i s t i m e , y o u s h o u l d be a b l e t o f i g u r e 
o u t 
what 
v a l u e s 
t o 
f i l l i n t h i s command. S i n c e f o u r c h i p s i s a l l y o u c a n p u t o n 
t h e 
PC4 board, y o u HAVE t o be done b y now! 
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When y o u ' r e done p r o g r a m m i n g t h e c h i p s , a l l y o u have l e f t 
t o do 
i s i n s e r t them i n t h e P'C4 b o a r d . The f o u r s o c k e t s 
on 
t h e 
b o a r d 
a r e l a b e l e d f r o m 0 t o 3. S o c k e t #O i s t h e c l o s e s t t o t h e c o m p u t e r 
when t h e c a r t r i d g e i s p l u g g e d i n . The f i r s t EPROM m u s t b e p u t 
i n 
s o c k e t #0, t h e second EPROM i n s o c k e t # l , e t c . 
I n s e r t 
each 
c h i p 
i n t o i t s s o c k e t s o t h a t t h e n o t c h on t h e c h i p w i l l be t o t h e LEFT 
when t h e c a r t r i d g e i s p l u g g e d 
i n t o 
t h e 
c o m p u t e r . 
T h e r e 
i s a 
c o r r e s p o n d i n g n o t c h o r d o t on t h e s o c k e t t o h e l p you. S i n c e b o a r d 
d e s i g n s m i g h t v a r y , ALWAYS m a t c h up t h e n o t c h on 
t h e 
c h i p 
w i t h 
t h e mark on t h e s o c k e t , even i f t h i s p o s i t i o n i s d i f f e r e n t 
f r o m 
what w e ' v e g i v e n you. L i k e w i s e f o r t h e p l a c e m e n t 
o f 
s o c k e t 
#0, 
e t c . ; 
a l w a y s f o l l o w t h e m a r k i n g s on t h e b o a r d o r t h e i n s t r u c t i o n s 
t h a t come w i t h it. 


You s h o u l d u s e a p l a s t i c h o u s i n g f o r t h e c a r t r i d g e t o p r o t e c t i t 
and make i t e a s i e r t o i n s e r t . P l a c e t h e c a r t r i d g e , w i t h t h e EPROM 
s i d e up, i n t h e b o t t o m h a l f o f t h e h o u s i n g . T h i s i s t h e h a l f w i t h 
t h e p l a s t i c p i n s s t i c k i n g up. The c a r t r i d g e b o a r d has t w o n o t c h e s 
on each s i d e t h a t w i l l f i t r i g h t a r o u n d t h e p l a s t i c p i n s and h o l d 
t h e b o a r d s e c u r e l y i n p l a c e . Now snap t h e t o p h a l f 
o f 
t h e 
c a s e 
on. Once y o u do t h i s , i t may be d i f f i c u l t t o open t h e c a s e a g a i n . 
I f y o u w i s h , c u t a l i t t l e o f f t h e end o f each p l a s t i c p i n t o make 
o p e n i n g t h e c a s e e a s i e r . D o n ' t c u t more t h a n a b o u t 1 / 1 6 " o f f 
t h e 
p i n s o r t h e c a s e w i l l come open t o o e a s i l y . 
If y o u m i x d i f f e r e n t t y p e s o f c h i p s 
i n y o u r 
c a r t r i d g e , 
y o u ' l l 
have t o u s e o u r p r o c e d u r e t o c a l c u l a t e t h e 
a r e a s 
o f 
t h e 
BASIC 
program f o r each c h i p . Many t i m e s , however, y o u ' l l f i n d y o u r s e l f 
u s i n g o n l y one t y p e o f c h i p i n t h e c a r t r i d g e . I n t h o s e cases, y o u 
can c o n s u l t t h e f o l l o w i n g c h a r t f o r 
t h e 
c o r r e c t 
b e g i n n i n g 
and 
e n d i n g a d d r e s s e s , w i t h o u t h a v i n g t o do 
any 
c a l c u l a t i o n s . 
N o t e 
t h a t t h e f i r s t EPROM m u s t a l s o h o l d t h e DL/RUN r o u t i n e , w h i c h 
i s 
n o t shown i n t h e c h a r t . The 
f i r s t 
p a r t 
o f 
t h e 
BASIC 
p r o g r a m 
a l w a y s s t a r t s a t 2049 i n t h e c o m p u t e r . I t i s p u t o n t o 
t h e 
f i r s t 
EPROM s t a r t i n g a t b y t e 176 of t h e EPROM, t o l e a v e 
room 
f o r 
t h e 


DL/RUN r o u t i n e . A l l o f t h e o t h e r p a r t s o f t h e p r o g r a m a r e p u t 
on 
EPROM s t a r t i n g a t b y t e 0 of t h e c h i p . 


EPROM 


F i r s t 
2049, 10064 
2049, 18256 
2049, 34640 
Second 
10065, 18256 
18257, 34640 
34641, 40959 * 


T h i r d 
18257, 26448 
34641, 40959 * 
n o t needed 
F o u r t h 
26449, 34640 
n o t needed 
'I 
I' 


* The end a d d r e s s shown i s t h e end o f t h e BASIC 
a r e a . 
I f t h i s 
l a s t a r e a i s r e q u i r e d , y o u may u s e a 2764 ( 8 K ) f o r i t . 
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CUSTOMIZING THE KERNAL 


Everybody has t h e i r own l i s t o f changes t h e y ' d l i k e t o make 
t o 
t h e i r Commodore 64. Maybe y o u d o n ' t l i k e t h e 
s c r e e n 
c o l o r s , 
o r 


y o u ' r e t i r e d o f t y p i n g ",8" 
e v e r y t i m e y o u 
l o a d 
a 
program, 
o r 
y o u ' d l i k e t h e s c r e e n t o say "WELCOME TO BOB'S COMPUTER" when y o u 
t u r n t h e computer on. These and o t h e r changes c a n be a c c o m p l i s h e d 
e a s i l y . Y o u ' l l need an EPROM 
programmer, 
a 
2764 
EPROM 
and 
a 


2 4 / 2 8 - p i n a d a p t e r . A r e f e r e n c e book such as "The Anatomy 
o f 
t h e 
Commodore 64" i s a l s o immensely h e l p f u l , e s p e c i a l l y i f y o u 
want 
t o go beyond t h e m o d i f i c a t i o n s we p r e s e n t h e r e . 


To s t a r t o f f w i t h , y o u s h o u l d g e t a c o p y o f 
r e v i s i o n 
3 
o f 
t h e 
KERNAL i f y o u d o n ' t a l r e a d y have i t (SX-64 owners can 
use 
t h e i r 
p r e s e n t KERNAL). You c o u l d p r o c e e d b y c o p y i n g t h e KERNAL down 
t o 
RAM memory a t , say, $4000-5FFF, 
b u t t h e n y o u ' l l have t o t r a n s l a t e 
addresses back and f o r t h . A b e t t e r way i s t o c o p y t h e KERNAL 
ROM 
down t o t h e RAM u n d e r n e a t h i t and s w i t c h o u t t h e ROM. 
You can r u n 
y o u r system f r o m t h e R A M c o p y as l o n g as y o u d o n ' t t r y t o m o d i f y 
a system r o u t i n e as i t i s b e i n g 
e x e c u t e d 
( s u c h 
as 
t h e 
s c r e e n 
e d i t o r and I R Q r o u t i n e s ) . T h i s way y o u ' l l be a b l e 
t o 
t e s t 
y o u r 
changes as y o u make them. Y o u ' l l have t o c o p y t h e BASIC ROM 
down 
t o RAM as w e l l , s i n c e BASIC g e t s s w i t c h e d o f f 
w i t h 
t h e 
KERNAL. 
You w o n ' t b e a b l e t o u s e a c a r t r i d g e based m o n i t o r e i t h e r , 
s i n c e 
c a r t r i d g e s a r e a l s o s w i t c h e d o u t . O f c o u r s e , y o u s h o u l d save y o u r 
custom KERNAL t o d i s k f r o m t i m e t o t i m e as a p r e c a u t i o n , b u t t h i s 
method works w e l l f o r us. 


S t a r t 
b y 
c o p y i n g 
BASIC 
and 
t h e 
KERNAL 
down 
t o 
RAM 
w i t h 
T A000 BFFF A000 
(BASIC) 
and 
T EOOO FFFF EOOO 
(KERNAL). 
Now 
s w i t c h o f f t h e ROMs b y c h a n g i n g l o c a t i o n 
$0001 
t o 
a 
$35. 
You 
s h o u l d n ' t n o t i c e any change, b u t y o u ' r e now o p e r a t i n g o u t o f RAM. 
Now change l o c a t i o n $FDD6 t o $E5 ( b e s u r e and change i t back 
t o 
$E7 b e f o r e b u r n i n g an EPROM 
c o p y ! ) . 
T h i s 
change 
p r e v e n t s 
t h e 
RESET r o u t i n e f r o m s w i t c h i n g t h e ROMs 
b a c k 
i n when 
y o u 
do 
a 
' s o f t ' RESET (SYS 64738 o r G FCE2). S i n c e many m o d i f i c a t i o n s w i l l 
change t h e s t a r t u p d e f a u l t s , y o u ' l l need a 
s o f t 
RESET 
t o 
t e s t 
them. A ' h a r d ' RESET w i t h a RESET b u t t o n w i l l 
s t i l l 
s w i t c h 
t h e 
ROMs back i n , b u t i t w o n ' t w i p e o u t y o u r R A M 
copy. 
T r y 
a 
s o f t 
RESET now w i t h G FCE2. A f t e r an e x t r a - l o n g pause y o u w i l l g e t t h e 
f a m i l i a r s t a r t u p s c r e e n , o n l y w i t h 51216 b y t e s f r e e ! R e l a x , 
t h i s 
j u s t means t h e RAM t e s t r o u t i n e 
g o t 
a l l 
t h e 
way 
t o 
t h e 
V I C 
c o n t r o l r e g i s t e r a t $DO11 b e f o r e f i n d i n g any 'non-RAM'. 


F i g u r e 14-1 l i s t s some s h o r t 
p a t c h e s 
y o u 
c a n 
make, 
j u s t 
f o r 
s t a r t e r s . L e t ' s t a k e a b r i e f l o o k a t each o f them, s t a r t i n g w i t h 
e v e r y o n e ' s f a v o r i t e , t h e d e f a u l t c o l o r s . The d e f a u l t 
b o r d e r 
and 
background c o l o r s a r e l o c a t e d i n a 
t a b l e 
o f 
v a l u e s 
t h a t 
g e t 
w r i t t e n i n t o t h e V I C c h i p on powerup, RESET 
o r 
RUN/STOP-RESTQRE 


by t h e V I C 
i n i t i a l i z a t i o n r o u t i n e 
a t 
$E5AA. 
The 
b o r d e r 
and 
b a c k g r o u n d c o l o r codes a r e l o c a t e d a t ECD9 & ECDA, 
r e s p e c t i v e l y . 
These c o l o r s a r e s p e c i f i e d u s i n g t h e c o l o r RAM codes 
( $ 0 0 = b l a c k , 


$ O l = w h i t e , e t c . ) NOT t h e A S C I I p r i n t commands 
( $ 9 0 = b l a c k 
e t c . ) . 


The d e f a u l t c h a r a c t e r c o l o r i s l o c a t e d a t $E535, 
i n t h e 
s c r e e n 
i n i t i a l i z a t i o n r o u t i n e ( w h i c h c a l l s t h e V I C c h i p 
i n i t r o u t i n e ) . 
The c h a r a c t e r c o l o r i s a l s o s p e c i f i e d u s i n g c o l o r RAM codes. 
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Next on our l i s t i s a patch t o automatically enable repeating f o r 
a l l keys. To do t h i s we'll have t o i n s e r t a JSR 
in 
t h e 
screen 


i n i t routine and p u t a short piece of code in t h e unused area 
a t 


$E4B7-D2. This simply s t o r e s an $80 i n t o the key repeat f l a g 
and 
returns. While you're a t i t , you might want t o adjust 
t h e 
delay 
before a key repeats and t h e speed a t which i t repeats (note two 
d i f f e r e n t locations t o change speed). The new 
values 
given 
are 
just suggestions, so experiment. 


Now we come t o a real handy p a i r of changes. F i r s t , we modify the 
BASIC LOAD and S A V E commands so they 
automatically 
go 
t o disk 
rather than tape when no device i s specified ( i . e . L O A D 
"PROG"). 


If you need t o specify a secondary address, though, y o u ' l l 
s t i l l 
have t o type t h e device number ( L O A D "PROGM,8,1). Likewise, 
you 
can d e f a u l t the O P E N command t o go t o t h e p r i n t e r i f no device i s 
specified. You'll s t i l l have t o supply t h e device number 
i f 
you 
need a secondary address. Neither of 
these 
changes 
a f f e c t the 
corresponding K E R N A L routines, since you must always specify 
the 
device number f o r them (unless you want t o get r e a l l y t r i c k y ) . 


Our next modification i s t o change 
the 
SHIFT-RUN/STOP 
( S h - R / S ) 


combination so t h a t i t loads the f i r s t program off the 
disk 
and 
runs i t . To do t h i s , you 
must 
f i r s t change 
the 
d e f a u l t 
L O A D 
device as given above. The Sh-R/S combination 
works 
by 
putting 
i t s command i n t o t h e keyboard buffer 
and 
then 
jumping 
t o 
the 
keyboard i n t e r p r e t loop. Since t h e keyboard 
buffer 
i s only 
10 
characters long, t h i s 1 imits our possible modifications. 
To 
f i t 
in a L O A D ":*" ( r e t u r n ) R U N ( r e t u r n ) command, we have t o use 
the 
shifted s h o r t c u t s , e.g. R shift-U f o r R U N , shown as rU. The 
only 
way t o g e t around t h i s l i m i t a t i o n i s t o patch i n t o t h e 
keyboard 
i n t e r p r e t loop a t $E5EE, and have i t perform your custom 
command 
d i r e c t l y . 


Our f i n a l modification involves 
t h e 
s t a r t u p 
screen, 
which 
i s 
printed in t h r e e separate parts by a routine 
a t $E422-46. 
The 
f i r s t p a r t , u p t o "64K RAM SYSTEM ", i s stored 
as 
a t a b l e 
of 
ASCII characters 
a t 
$E473-AB. 
The 
number 
of 
bytes 
f r e e i s 
calculated and printed next, a n d 
then 
the 
"BASIC 
BYTES 
FREE" 
message a t $E45F-72 i s printed. The f i r s t part 
printed 
can 
be 
a l t e r e d by j u s t changing the ASCII codes. To 
disable t h e 
bytes 
f r e e and reuse i t s me'ssage area, make t h e l a s t two 
modifications 
shown. 
You 
can 
then 
continue your 
screen 
message 
in 
t h e 
"BASIC BYTES FREE" area. 


If you want t o go much 
beyond 
t h e 
modifications 
here, 
y o u ' l l 
probably need some e x t r a space t o p u t code i n . 
The 
only 
unused 
area l e f t i s a t $E4B7-D2, 
b u t you 
could 
f r e e 
u p 
some 
space 
(nearly ZK!) i f you d o n ' t need the 
c a s s e t t e . 
Once 
you've 
made 
your changes, burn t h e code i n t o a 2764 EPROM and i n s t a l l 
i t in 
the computer using t h e A D adapter. 
Powerup 
and 
take your 
new 
computer f o r a t e s t drive! 
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F i g u r e 14-1: 
KERNAL MODIFICATIONS 


LOCATION 
ORIGINAL 
MODIFIED 
DESCRIPTION OF C H A N G E 


E5 s e e t e x t 
CHANGE TO $E7 BEFORE 
BURNING EPROM! 


ECD9-DA 
O E 06 
Your c h o i c e 
D e f a u l t b o r d e r and 
background c o l o r s 


E535 
O E 06 
Your c h o i c e 
D e f a u l t c h a r a c t e r c o l o r 


E536-8 
STA $0286 
JSR $E4B7 
C a l l key r e p e a t r o u t i n e 


E4B7-BF 
A A ... 
STA $0286 
S e t c h a r a c t e r c o l o r 
. . . . . 
L D A #$80 
Value s o a l l keys r e p e a t 
... AA 
STA $028A 
Save i n key r e p e a t f l a g 
( f i l l e r ) 
RTS 
Return t o s c r e e n i n i t 


r o u t i n e 


E53A/EBlD 
04 


E A E A 
10 


Key r e p e a t speed - n o t e 
2 p l a c e s t o change 


Key r e p e a t d e l a y 


El D A 
01 ( t a p e ) 
08 ( d i s k ) 
Change LOAD/SAVE d e f a u l t 
d e v i c e number 


E228 
01 ( t a p e ) 
04 ( p r i n t e r ) Change O P E N d e f a u l t 
d e v i c e number 


No. c h a r a c t e r s i n 
SHIFT-R/S command 


E5F4-F5 
E6 E C 
BF E4 
Location of command 


E4CO-C9 
AA ... AA 
4C CF 22 3A 
New v e r s i o n of command 
2A 22 O D 
l o " : * " ( r e t u r n ) 
52 D5 O D 
rU 
( r e t u r n ) 


E473-AB 
"**** COM.." 
Your c h o i c e 
Change s t a r t u p message 


E45F-72 
"BYTES FREE" 
Your c h o i c e 
Reuse b y t e s f r e e space 


E430-32 
L D A $37; SEC 
JMP $E43D 
D i s a b l e no. b y t e s f r e e 


c a l c / p r i n t 
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REUSING THE TAPE AREAS I N THE KERNAL 


The KERNAL ROM c o n t a i n s 8K of machine 
l a n g u a g e 
r o u t i n e s . 
These 
r o u t i n e s h a n d l e a l l c o m m u n i c a t i o n w i t h t h e c o m p u t e r ' s 
p e r i p h e r a l 
d e v i c e s : keyboard, screen, s e r i a l ( d i s k o r 
p r i n t e r ) , 
RS232 
and 
c a s s e t t e t a p e . It may be h a r d t o b e l i e v e , b u t t h e 
c a s s e t t e 
t a p e 
r o u t i n e s t a k e up more ROM space t h a n any o t h e r s i n g l e f u n c t i o n of 
t h e KERNAL. I n f a c t , 
n e a r l y 2K o f t h e 8K KERNAL i s d e d i c a t e d 
t o 
t h e t a p e r o u t i n e s ! T h i s may 
seem 
l i k e 
a 
tremendous 
waste 
o f 
space, s i n c e most C64 owners have d i s k d r i v e s and r a r e l y i f e v e r 
use t a p e . I f y o u have a PROMENADE, y o u can d i s p e n s e w i t h t h e t a p e 
r o u t i n e s 
and 
i n s t a l l 
some 
o t h e r 
u t i l i t i e s 
i n t h e i r 
p l a c e . 
P o s s i b l e r e p l a c e m e n t s i n c l u d e a 
DOS 
wedge, 
s m a l l 
ML 
m o n i t o r , 
s i m p l e t r a c k / s e c t o r e d i t o r , BASIC programming a i d o r even a 
f a s t 
l o a d 
u t i l i t y . 
As 
a 
sample 
of 
t h e 
p o s s i b i l i t i e s , 
t h e 
d i s k 
accompanying t h i s book i n c l u d e s a m o d i f i e d KERNAL 
w i t h 
t h e 
DOS 
wedge i n s t a l l e d . 


Y o u ' l l have t o make s u r e y o u r r e p l a c e m e n t r o u t i n e s w i l l 
a c t u a l l y 
f i t i n t h e space a v a i l a b l e , o f c o u r s e . Y o u ' l l p r o b a b l y a l s o 
have 
t o a l t e r them so t h e y w i l l e x e c u t e a t t h e new l o c a t i o n . 
Most 
ML 
programs a r e n o t r e l o c a t a b l e as i s ; t h e y a r e w r i t t e n t o r e s i d e a t 
a p a r t i c u l a r p l a c e i n memory. I f t h e 
program 
i s one 
y o u 
have 
w r i t t e n y o u r s e l f , y o u may be a b l e t o make t h e 
n e c e s s a r y 
changes 
w i t h o u t much t r o u b l e . On t h e o t h e r hand, i f t h e 
program 
t o be 
i n s t a l l e d i n t h e KERNAL i s a p u b l i c domain o r commercial p r o d u c t , 
r e l o c a t i n g i t c o u l d be d i f f i c u l t 
t o 
a c c o m p l i s h . 
O b v i o u s l y , 
we 
c a n ' t c o v e r a l l t h e d i f f e r e n t programs 
i n t h i s 
book 
t h a t 
y o u 
m i g h t want t o i n s t a l l i n t h e KERNAL. 
A l l we can do i s o f f e r 
some 
g e n e r a l g u i d e l i n e s on 
r e l o c a t i n g 
programs 
and 
p o i n t 
o u t 
t h e 
KERNAL a r e a s t h a t can be r e u s e d . 


There a r e s e v e r a l c o n s i d e r a t i o n s when m o d i f y i n g a program f o r i t s 
new 
l o c a t i o n 
i n t h e 
KERNAL. 
F i r s t , 
y o u 
must 
a l t e r 
memory 
r e f e r e n c e s so t h a t t h e y r e f e r t o t h e new 
a r e a 
r a t h e r 
t h a n 
t h e 
o r i g i n a l area. N o t a l l memory r e f e r e n c e s w i l l need t o be a l t e r e d , 
however. O n l y r e f e r e n c e s t o l o c a t i o n s w i t h i n t h e o r i g i n a l program 
a r e a s h o u l d be a l t e r e d . References t o a r e a s o u t s i d e t h e 
o r i g i n a l 
program area, such as KERNAL s u b r o u t i n e s o r system RAM l o c a t i o n s , 
must s t a y t h e same. 


R e f e r e n c e s t o l o c a t i o n s w i t h i n t h e o r i g i n a l 
program 
a r e a 
c o u l d 
o c c u r as 
a b s o l u t e , 
i n d e x e d 
o r 
i n d i r e c t 
r e f e r e n c e s . 
A b s o l u t e 
r e f e r e n c e s a r e easy t o s p o t 
s i n c e 
t h e y 
a r e 
a l w a y s 
t h r e e - b y t e 
i n s t r u c t i o n s , 
e.g. 
JSR $1234. 
I n d e x e d 
i n s t r u c t i o n s 
a r e 
a1 so 
u s u a l l y t h r e e b y t e i n s t r u c t i o n s , such 
as 
LDA $1100,X. 
I n d i r e c t 
r e f e r e n c e s may be t h r e e b y t e s , such as JMP ($2000) o r 
t w o - b y t e s , 
such as LDA ($FB),Y - w h i c h 
i s a 
c o m b i n a t i o n 
o f 
i n d e x e d 
and 
i n d i r e c t . I n d i r e c t r e f e r e n c e s w i l l 
be 
t h e 
h a r d e s t 
t o change, 
s i n c e t h e y u s e t h e 
c o n t e n t s 
o f 
some 
l o c a t i o n 
( a 
v e c t o r ) 
t o 
s p e c i f y t h e a c t u a l address. You must change t h e 
v e c t o r 
c o n t e n t s 
i n o r d e r t o a d j u s t t h e i n s t r u c t i o n f o r a new l o c a t i o n . Many t i m e s 
t h e r e i s a s e c t i o n o f 
code 
i n t h e 
program 
w h i c h 
s t o r e s 
t h e 
c o r r e c t c o n t e n t s i n t o t h e v e c t o r . You must change t h i s code t o o . 
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Branch i n s t r u c t i o n s w i l l n o t need t o be m o d i f i e d , s i n c e t h e y 
a r e 


a1 1 r e l a t i v e i n s t r u c t i o n s . T h a t i s , t h e t a r g e t address 
( l o c a t i o n 
t o b r a n c h t o ) i s a l w a y s f o u n d b y a d d i n g o r s u b t r a c t i n g a 
c e r t a i n 
number o f b y t e s ( t h e 
o f f s e t ) 
t o t h e 
l o c a t i o n 
o f 
t h e 
b r a n c h 
i n s t r u c t i o n i t s e l f . The 
a c t u a l 
t a r g e t 
a d d r e s s 
i s NOT 
s t o r e d 
d i r e c t l y , j u s t t h e o f f s e t amount. As l o n g as y o u d o n ' t i n s e r t 
o r 
d e l e t e any code i n between t h e b r a n c h i n s t r u c t i o n and i t s t a r g e t 
address, t h e o f f s e t w i l l be t h e same no m a t t e r 
where 
i n memory 
t h e program code r e s i d e s . 


Another c o n s i d e r a t i o n when p u t t i n g a program 
i n t h e 
KERNAL 
i s 
whether i t a l t e r s i t s e l f as i t r u n s . Many programs 
s t o r e 
v a l u e s 
i n t o i n s t r u c t i o n s o r d a t a t a b l e s w i t h i n 
t h e m s e l v e s . 
I n 
such 
a 
case, y o u must r e l o c a t e t h e code 
o r 
t a b l e 
o u t s i d e 
t h e 
KERNAL 
area, s i n c e t h e KERNAL i s i n 
ROM, 
n o t 
RAM, 
and 
c a n n o t 
a l t e r 
i t s e l f . There a r e s e v e r a l a r e a s i n system RAM ( b e l o w $0400) w h i c h 
a r e used o n l y b y t h e t a p e r o u t i n e s , and t h e s e a r e a s can be r e u s e d 
when t h e t a p e r o u t i n e s a r e removed. A l i s t o f t h e s e l o c a t i o n s 
i s 
g i v e n i n F i g u r e 15-2. U n f o r t u n a t e l y , t h e s e a r e a s d o n ' t amount 
t o 
much space. T h e r e a r e o t h e r , l a r g e r 
a r e a s 
i n memory 
t h a t 
a r e 
"unused", 
such as $02A7-02FF and $0334-03FF ( w h i c h 
i n c l u d e s 
t h e 
c a s s e t t e b u f f e r ) . So many commercial programs 
u s e 
t h e s e 
areas, 
however t h a t i n c o m p a t i b i l i t y w i t h some programs i s c e r t a i n . 
You 
may have b e t t e r success w i t h t h e a r e a 
a t 
$07E8-07FF, 
w h i c h 
i s 
much l e s s commonly used. Programs w i t h s p r i t e s may use t h i s area, 
so watch o u t . 


F i n a l l y , y o u must a l s o c o n s i d e r how y o u want 
t o 
s t a r t 
up 
y o u r 
program. You c o u l d j u s t use a S Y S c a l l t o s t a r t i t when 
needed, 
o r y o u c o u l d p a t c h i n t o t h e RESET p r o c e s s s o t h a t y o u r program i s 
s t a r t e d a u t o m a t i c a l l y . T h i s 
w o u l d 
be 
e s p e c i a l l y 
s u i t a b l e 
f o r 
programs such as a DOS wedge o r a 
BASIC 
programming 
a i d . 
Even 
b e t t e r , y o u m i g h t check a p a r t i c u l a r k e y d u r i n g 
RESET 
and 
o n l y 
s t a r t y o u r program i f t h e k e y was b e i n g h e l d down. T h i s w o u l d 
be 
v e r y u s e f u l when combined w i t h 
a 
m o n i t o r 
program. 
You 
s h o u l d 
always make s u r e t h e r e i s a way t o e x i t 
y o u r 
program 
back 
t o 
normal o p e r a t i o n , i n case y o u r program i s i n c o m p a t i b l e w i t h o t h e r 
programs. A l t e r n a t i v e l y , y o u c o u l d p u t y o u r m o d i f i e d KERNAL on 
a 
16K EPROM w i t h t h e o r i g i n a l KERNAL. As d e s c r i b e d e a r l i e r 
i n t h e 
s p e c i a l c a r t r i d g e h a r d w a r e c h a p t e r , y o u c o u l d go f r o m one 
KERNAL 
v e r s i o n t o t h e o t h e r w i t h a s i m p l e f l i c k of a s w i t c h . 


There a r e t o o l s a v a i l a b l e t o h e l p y o u r e l o c a t e a program f r o m one 
a r e a t o a n o t h e r . Most 
good 
m o n i t o r s 
have 
a 
s p e c i a l 
r e l o c a t e 
command, u s u a l l y c a l l e d " N " f o r "New l o c a t i o n " . B o t h t h e M I C R O M O N 
m o n i t o r on t h e program d i s k and 
t h e 
commercial 
p r o d u c t 
HESMON 
have t h e " N u command. It i s comparable t o a RENUMBER command 
f o r 
BASIC 
programs. 
It a l l o w s 
y o u 
t o 
a u t o m a t i c a l l y 
a d j u s t 
a l l 
t h r e e - b y t e i n s t r u c t i o n s w i t h i n t h e program b y a d d i n g an o f f s e t t o 
t h e address r e f e r e n c e d b y 
t h e 
i n s t r u c t i o n . 
Many 
programs 
use 
t a b l e s of t w o - b y t e v e c t o r s w h i c h w i l l a l s o need t o 
be 
a d j u s t e d . 
The " N u command has an o p t i o n t o h a n d l e v e c t o r t a b l e s t o o . 
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An example may h e l p c l a r i f y t h e " N " command. Suppose 
we 
have 
a 
program w h i c h n o r m a l l y e x e c u t e s a t $2000-2FFF and we want t o move 
i t up t o $6000-6FFF. 
F i r s t we must copy t h e o r i g i n a l 
v e r s i o n 
up 
t o t h e new l o c a t i o n w i t h t h e t r a n s f e r command: 
T 2000 2FFF 6000. 
Now we must a d j u s t t h e memory 
r e f e r e n c e s 
i n t h e 
new 
v e r s i o n . 
S i n c e 
we 
moved 
t h e 
code 
up 
$4000 
b y t e s 
i n 
memory 
($2000 + $4000 = $6000), 
we 
w o u l d 
u s e 
t h e 
f o l l o w i n g 
command: 
N 6000 6FFF 4000 2000 2FFF. 
P u t s i m p l y , t h e 
f i r s t 
two 
parameters (6000 6FFF) s p e c i f y where t h e new copy i s l o c a t e d , t h e 
t h i r d parameter (4000) s p e c i f i e s how f a r t h e code has been moved, 
and t h e l a s t two p a r a m e t e r s (2000 2FFF) s p e c i f y 
where 
t h e 
code 
was l o c a t e d o r i g i n a l l y . 


Some o f t h e s e p a r a m e t e r s may seem r e d u n d a n t , b u t t h e y 
a r e 
t h e r e 
f o r more g e n e r a l purposes. 
The 
f i r s t 
t w o 
p a r a m e t e r s 
a c t u a l l y 
d e f i n e t h e a r e a o f program code f o r t h e 
" N u 
command 
t o s e a r c h 


($6000-6FFF). I t w i l l n o t l o o k o u t s i d e 
t h i s 
area, 
p e r i o d . 
The 
l a s t two p a r a m e t e r s t e l l i t what r a n g e o f address references t o 
l o o k f o r ( $ 2 0 0 0 - ~ F F F ) . It w i l l i g n o r e any r e f e r e n c e t o an address 
o u t s i d e t h i s r a n g e . T h i s 
p r e v e n t s i t f r o m 
a l t e r i n g 
c a l l s 
t o 
KERNAL s u b r o u t i n e s , 
f o r 
i n s t a n c e 
( s i n c e 
we 
d i d n ' t 
move 
t h e 
KERNAL, 
t h o s e 
r e f e r e n c e s 
must 
s t a y 
t h e 
same). 
The 
m i d d l e 
parameter ($4000) i s t h e offset t o add 
t o t h e 
r e f e r e n c e s 
t h a t 
meet t h e o t h e r c o n d i t i o n s . 


Suppose now t h a t we wanted t o move t h e code t h e o t h e r 
d i r e c t i o n , 


i . e . 
f r o m $6000 down t o $2000. What o f f s e t w o u l d we use? I f y o u 
s a i d 
-84000, 
y o u ' r e 
c l o s e . 
We 
c a n ' t 
use 
n e g a t i v e 
numbers 
d i r e c t l y , however. What we have t o 
do 
i s u s e 
a 
l a r g e 
enough 
o f f s e t so t h a t when 
i t ' s 
added 
t o 
$6000, 
t h e 
r e s u l t 
"wraps 
around" p a s t $FFFF and ends up a t $2000. The c o r r e c t v a l u e t o use 
i s $C000, s i n c e $6000 + $COO0 = $012000, w h i c h becomes $2000 when 
t h e h i g h e s t b y t e i s dropped. The e a s i e s t way t o c a l c u l a t e o f f s e t s 
i s t o use t h e s u b t r a c t command " - " ( a v a i l a b l e i n b o t h HESMON 
and 
MICROMON). Always t a k e t h e new l o c a t i o n and s u b t r a c t t h e original 
l o c a t i o n f r o m i t (NEW - OLD), r e g a r d l e s s o f w h i c h 
d i r e c t i o n 
y o u 
a r e moving i n memory. The s u b t r a c t command r e q u i r e s t h a t t h e 
" - " 


come b e f o r e t h e numbers t o be 
s u b t r a c t e d , 
r a t h e r 
t h a n 
between 
them, so t h e g e n e r a l f o r m 
i s : - NEW OLD. 
I n o u r 
f i r s t 
case, 
moving up f r o m $2000 t o $6000, we would u s e - 6000 2000 
and 
g e t 
t h e answer $4000. I n t h e second c a s e we w o u l d use - 2000 6000 and 
g e t t h e answer $C000. 


One f i n a l 
word 
a b o u t 
a d j u s t i n g 
v e c t o r 
t a b l e s 
w i t h 
t h e 
" N u 


command. I f we want t o a d j u s t a 
t a b l e 
o f 
v e c t o r s 
r a t h e r 
t h a n 
program code, we must p u t a " W ' 
a t t h e end o f 
t h e 
" N " 
command. 


''W" 
s t a n d s f o r "Words", meaning t w o - b y t e v a l u e s . Each v e c t o r must 
be a t w o - b y t e v a l u e , i n s t a n d a r d l o - b y t e / h i - b y t e 
o r d e r . 
L e t ' s 
go back t o o u r f i r s t example, moving a program f r o m $2000 
up 
t o 
$6000. 
Suppose 
t h e 
o r i g i n a l 
program 
c o n t a i n s 
ML 
code 
a t 


$2000-2DFF and a v e c t o r t a b l e a t 
$2E00-2FFF. 
I n t h e 
r e l o c a t e d 
v e r s i o n t h e code w o u l d 
be 
a t 
$6000-6DFF 
and 
t h e 
v e c t o r s 
a t 


$6E00-6FFF. The p r o p e r sequence o f commands t o u s e would be: 


T 2000 2FFF 6000 
T r a n s f e r t h e program 
N 6000 6DFF 4000 2000 2FFF 
A d j u s t t h e ML code 
N 6E00 6FFF 4000 2000 2FFF W 
A d j u s t t h e v e c t o r s 
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N o t e t h a t i n t h e t w o " N " commands 
we 
used 
d i f f e r e n t 
a r e a s 
t o 
s e a r c h ( f i r s t t w o p a r a m e t e r s ) b u t t h e same r a n g e o f r e f e r e n c e s t o 
l o o k f o r ( f o u r t h and f i f t h p a r a m e t e r s ) . The o f f s e t s t a y s t h e same 
t o o . What c o u l d be s i m p l e r , y o u say. 


An even more p o w e r f u l t o o l t h a n a m o n i t o r f o r r e l o c a t i n g programs 
i s a 
t y p e 
o f 
p r o g r a m 
c a l l e d 
a 
SYMBOLIC DISASSEMBLER. 
These 
d i s a s s e m b l e r s do 
more 
t h a n 
a 
m o n i t o r ' s 
d i s a s s e m b l e 
command, 
because t h e y p r o d u c e an o u t p u t f i l e s u i t a b l e 
f o r 
u s e 
w i t h 
an 
assembler package. They a r e c a l l e d SYMBOLIC d i s a s s e m b l e r s because 
t h e y i n v e n t s y m b o l i c l a b e l s f o r 
memory 
l o c a t i o n s , 
r a t h e r 
t h a n 
s p e c i f y i n g t h e l o c a t i o n d i r e c t l y . T h i s means y o u can 
change 
t h e 
d e f i n i t i o n o f t h e l a b e l a t t h e b e g i n n i n g o f t h e program, and 
a l l 
r e f e r e n c e s t o t h a t l a b e l t h r o u g h o u t t h e program w i l l u s e t h e 
new 
v a l u e a u t o m a t i c a l l y when t h e program i s reassembled. 
T h i s 
makes 
i t easy t o move an e n t i r e program 
t o 
a 
new 
l o c a t i o n 
o r 
even 
r e a r r a n g e t h e p a r t s o f t h e program r e l a t i v e t o each o t h e r . 


One e x c e l l e n t u t i l i t y 
o f 
t h i s 
t y p e 
i s THE 
SOURCE 
GENERATOR 
( a v a i l a b l e f r o m CSM S o f t w a r e ) . T h i s program can p r o d u c e assembler 
f i l e s 
s u i t a b l e 
f o r 
s e v e r a l 
d i f f e r e n t 
assembler 
packages, 
i n c l u d i n g Commodore's. I t can 
a l s o 
p r o d u c e 
a 
CROSS-REFERENCE 
l i s t i n g f o r 
t h e 
program 
b e i n g 
disassembled, 
showing 
e v e r y 
l o c a t i o n r e f e r r e d t o b y t h e program and where i n t h e program each 
l o c a t i o n i s r e f e r r e d t o . T h i s i s t r e m e n d o u s l y 
u s e f u l 
f o r 
many 
d i f f e r e n t purposes. When r e l o c a t i n g a program, f o r i n s t a n c e , 
y o u 


c a n u s e 
t h i s 
f e a t u r e 
t o 
v e r i f y 
t h a t 
a l l 
o f 
t h e 
p r o g r a m ' s 
r e f e r e n c e s t o i t s e l f were a c t u a l l y changed as d e s i r e d , 
and 
t h a t 
o t h e r r e f e r e n c e s were n o t changed. A 
s y m b o l i c 
d i s a s s e m b l e r 
was 
used t o r e s e a r c h t h e KERNAL and DOS wedge 
f o r 
t h i s 
c h a p t e r . 
A 
c o m p l e t e 
assembly 
l i s t i n g o f 
t h e 
KERNAL 
was 
p r e p a r e d 
and 
c r o s s - r e f e r e n c e d ( t h e s p e c i f i c a t i o n s f o r d o i n g t h i s a r e 
i n c l u d e d 
on d i s k w i t h t h e p a c k a g e ) . By e x a m i n i n g t h e c r o s s - r e f e r e n c e , 
t h e 
areas o f t h e KERNAL t h a t a r e used o n l y b y t h e t a p e r o u t i n e s 
were 
i d e n t i f i e d , as w e l l as t h e system 
RAM 
l o c a t i o n s 
used 
o n l y 
b y 
t a p e . 


I n o r d e r t o r e u s e t h e t a p e 
a r e a s , 
we 
must 
make 
a 
few 
m i n o r 
m o d i f i c a t i o n s t o t h e KERNAL. A f t e r a l l , t h e r e i s no 
l o n g e r 
any 
way t o access t a p e , so we must i n t e r c e p t a l l 
r e f e r e n c e s 
t o i t . 
S p e c i f i c a l l y , any 
a t t e m p t 
t o 
access 
d e v i c e 
1 
( t a p e ) 
s h o u l d 
p r o d u c e an 
"ILLEGAL 
D E V I C E " 
e r r o r . 
T h i s 
i s a c c o m p l i s h e d 
b y 
m o d i f y i n g t h e LOAD, 
S A V E 
and 
OPEN 
r o u t i n e s . 
I f d e v i c e 
1 
i s 
r e f e r e n c e d , we f o r c e t h e r o u t i n e t o jump t o $F713, w h i c h 
r e t u r n s 
t h e "ILLEGAL D E V I C E " e r r o r . You 
may 
a l s o 
w i s h 
t o change 
t h e 
d e f a u l t d e v i c e f o r LOAD, 
SAVE and OPEN t o d e v i c e 
8 
r a t h e r 
t h a n 
d e v i c e 1 
( s e e 
t h e 
c h a p t e r 
on 
KERNAL 
m o d i f i c a t i o n s ) . 
It i s 
e s p e c i a l l y i m p o r t a n t t o p r e v e n t t h e OPEN r o u t i n e f r o m s e t t i n g 
up 
a f i l e t o d e v i c e 1, because o t h e r r o u t i n e s such as C H K I N ( p r e p a r e 
f o r 
i n p u t ) 
and 
CHKOUT 
( p r e p a r e 
f o r 
o u t p u t ) 
depend 
on 
t h e 
p a r a m e t e r s s e t up by OPEN. I f y o u p r e v e n t a f i l e f r o m e v e r 
b e i n g 


OPEN'ed t o d e v i c e 1, t h e n t h e o t h e r r o u t i n e s such 
as 
C H K I N 
and 
CHKOUT w i l l never t r y t o access t h a t d e v i c e e i t h e r . 
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Figure 15-1: 
KERNAL TAPE AREAS 


MEM. 
AREA 
BYTES 
DESCRIPTION 
PATCH NEEDED 


I R Q - Check t a p e keys 
EA61 JMP $EA7B 


Tape messages 
Tape CHRIN r o u t i n e 
Tape CHROUT r o u t i n e 
Tape C H K I N check 
** 


Tape CHKOUT check 
Tape CLOSE r o u t i n e 
Tape OPEN r o u t i n e 
F38B JMP $F713 


Tape LOAD r o u t i n e 
F4B6 BCC $F4AF 


Tape S A V E r o u t i n e 
F5F8 BCC $F5F1 


M a i n t a p e r o u t i n e s 
** F617 JSR $F22A 


I n i t . b u f f e r p o i n t e r 
NOP's o r own code 
Tape I R Q v e c t o r s 


** 
T r a n s f e r $FB8E-FB96 t o $F22A-F232! 


Figure 15-2: TAPE RAM LOCATIONS 


$92 
96 
9B 
9F 
A6 
80-83 
See $FD5F above 
BE 
029F-02AO 


F i g u r e 15-1 l i s t s t h e c o m p l e t e s e t o f 
a r e a s 
used 
by 
t h e 
t a p e 
r o u t i n e s . The main s e t o f t a p e r o u t i n e s i s l o c a t e d f r o m $F72C 
t o 


$FCDO, w h i c h i n c l u d e s a b o u t 1500 b y t e s . S e v e r a l s m a l l e r a r e a s a r e 
a l s o a v a i l a b l e , w h i c h c a n be used t o s t o r e 
s u b r o u t i n e s 
o r 
d a t a 
t a b l e s f o r y o u r program. As e x p l a i n e d above, some 
areas 
r e q u i r e 
t h a t a p a t c h be i n s e r t e d i n t h e KERNAL i f t h e y a r e 
t o be 
used. 
These p a t c h e s p r e v e n t t h e KERNAL f r o m e v e r c a l l i n g 
t h e 
r o u t i n e s 
y o u have removed f r o m t h e s e areas. The b e s t 
way 
t o m o d i f y 
t h e 
KERNAL i s t o 
copy i t down 
t o 
RAM 
a t 
$2000 
and 
make 
y o u r 
m o d i f i c a t i o n s t o t h e RAM v e r s i o n . We 
s u g g e s t t h a t 
y o u f i l l 
t h e 
unused a r e a s o f y o u r m o d i f i e d KERNAL w i t h some v a l u e such as 
$FF 


so t h a t l a t e r on y o u can s p o t t h e s e a r e a s e a s i l y . Then i n s e r t t h e 
c o r r e s p o n d i n g p a t c h i f one i s g i v e n . Make y o u r 
m o d i f i c a t i o n s 
i n 
t h e o r d e r g i v e n . 
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One p a t c h i n p a r t i c u l a r r e q u i r e s some e x p l a n a t i o n . 
A t 
$FB8E-96, 


smack i n t h e m i d d l e o f t h e main 1 5 0 0 - b y t e b l o c k o f t a p e code, a r e 
n i n e b y t e s o f code t h a t a r e a l s o used 
b y 
t h e 
s e r i a l 
bus 
SAVE 
r o u t i n e . T h i s b r e a k s t h e b l o c k o f r e u s a b l e code i n t o t w o 
p i e c e s . 
W h i l e t h i s may be a c c e p t a b l e i n many cases, i n o t h e r 
cases 
y o u 
may need an u n i n t e r r u p t e d b l o c k o f code. We can a r r a n g e 
t h i s 
by 
moving t h e n i n e b y t e s o f code somewhere e l s e i n t h e 
KERNAL 
and 
c h a n g i n g t h e c a l l t h a t r e f e r e n c e s them. One 
of 
t h e 
s m a l l 
t a p e 
a r e a s a v a i l a b l e , a t $F22A i n C H K I N , i s e x a c t l y n i n e 
b y t e s 
l o n g . 
T r a n s f e r t h e p i e c e o f code f r o m t h e t a p e b l o c k t o t h i s a r e a 
w i t h 
y o u r m o n i t o r ( T FB8E FB96 F22A). Do t h i s BEFORE y o u f i l l t h e main 
t a p e b l o c k w i t h $ F F t s , o f c o u r s e . Then change 
t h e 
JSR $FB8E 
a t 


$F617 t o JSR $F22A. T h e r e i s a s l i g h t r i s k of making y o u r 
KERNAL 
i n c o m p a t i b l e w i t h some programs 
by 
d o i n g 
t h i s , 
b u t i t seems 
e x t r e m e l y remote. 


S e v e r a l RAM l o c a t i o n s a r e a l s o made a v a i l a b l e 
when 
y o u 
abandon 
t h e KERNAL t a p e r o u t i n e s . The c o m p l e t e l i s t i s g i v e n 
i n F i g u r e 
15-2. H a v i n g e x t r a z e r o page l o c a t i o n s i s e s p e c i a l l y u s e f u l . N o t e 
t h a t t h e c a s s e t t e b u f f e r p o i n t e r a t $82-83 
i s n o r m a l l y 
s e t 
t o 
p o i n t t o $033C b y t h e KERNAL RAMTAS r o u t i n e ($FF50). We have 
y o u 
d i s a b l e t h i s f u n c t i o n b y i n s e r t i n g NOP's a t $FD5F-66. 
A g a i n t h e r e 
i s a v e r y s l i g h t p o s s i b i l i t y o f i n c o m p a t i b i l i t y when y o u do t h i s . 


There a r e o t h e r two a r e a s n o t l i s t e d w h i c h o n l y t h e t a p e r o u t i n e s 
r e f e r t o d i r e c t l y : $0100-013E and $033C-03FB. 
These a r e a s may n o t 
r e a l l y be o f much u s e s i n c e so many commercial 
programs 
a l r e a d y 
use them. HESMON uses some o f t h e $0100-3E a r e a ( t h e 
b o t t o m 
end 
o f t h e s t a c k ) , f o r i n s t a n c e , and many p r o t e c t i o n schemes u s e 
t h e 


$033C-FB a r e a ( t h e c a s s e t t e b u f f e r ) . I f t h e program 
y o u 
i n s t a l l 
i n t h e KERNAL uses t h e s e a r e a s , y o u s h o u l d make s u r e t h e r e 
i s a 
way t o d i s a b l e y o u r program o r s w i t c h o f f y o u r 
m o d i f i e d 
KERNAL 
e n t i r e l y . The DOS wedge i n s t a l l e d i n o u r sample KERNAL uses 
p a r t 
o f t h e c a s s e t t e b u f f e r f o r d a t a s t o r a g e ($0337-8A). I f t h e 
wedge 
i n t e r f e r e s w i t h a program y o u w i s h t o use, s i m p l y d i s a b l e i t w i t h 
t h e Q u i t command @Q. 


Our m o d i f i e d KERNAL w i t h t h e DOS wedge 
i s i n t h e 
f i l e c a l l e d 


"KERNAL/WEDGEU on t h e program 
d i s k 
w i t h 
t h i s 
book. 
The 
t a p e 
r o u t i n e s were removed a c c o r d i n g t o t h e t a b l e above, and t h e wedge 
was i n s t a l l e d a t $F800-FB8B i n t h e main t a p e b l o c k . The wedge 
i s 
p a t c h e d i n t o t h e BASIC c o l d s t a r t r o u t i n e a t $E39A, and i n t o t h e 
N M I r o u t i n e a t $FE6F. T h i s means t h a t t h e wedge w i l l be a c t i v a t e d 
b y e i t h e r a RESET o r RUN/STOP-RESTORE 
sequence. The f i l e l o a d s i n 
a t $2000-3FFF t o make b u r n i n g i t o n t o EPROM 
e a s i e r . 
The 
PROMOS 
command t o u s e f o r a s t a n d a r d 2764 (8K) EPROM i s : 


T h a t a b o u t wraps i t up f o r t h i s s u b j e c t . I f y o u 
a b s o l u t e l y 
have 
t o have more room i n t h e KERNAL, t h e RS232 r o u t i n e s a r e a b o u t t h e 
o n l y o t h e r n o n e s s e n t i a l code y o u can g e t r i d o f . These amount 
t o 
l e s s t h a n l K , w i t h t h e b i g g e s t b l o c k a t 
$EEBB-FOBC 
b e i n g 
a b o u t 
1 / 2 K . If 
y o u w i s h t o p u r s u e t h i s , we recommend u s i n g a 
s y m b o l i c 
d i s a s s e m b l e r w i t h c r o s s - r e f e r e n c e c a p a b i l i t y as d i s c u s s e d 
above. 
Good l u c k ! 
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U O D I F Y I N G THE 1541 DOS 


I n t h i s c h a p t e r w e ' l l l o o k a t some o f 
t h e 
i m p o r t a n t 
t h i n g s 
t o 
know if you want t o m o d i f y t h e DOS ROMs i n y o u r 
1541. 
The 
1541 
DOS i s c o n t a i n e d on two 8K ROMS. One ROM r e s i d e s a t $C000-DFFF i n 
memory and t h e o t h e r a t $E000-FFFF. 
F o r 
convenience 
w e ' l l 
c a l l 
them t h e C - D and E-F ROMs, r e s p e c t i v e l y . 


Any t i m e you make m o d i f i c a t i o n s t o e i t h e r ROM, you must a d j u s t o r 
d i s a b l e t h e ROU checksum. On a powerup, RESET, UJ o r 
U I 
command 
each ROM i s checksummed s e p a r a t e l y by a d d i n g up t h e b y t e s i n it, 
u s i n g ADC, 
t o g e t a o n e - b y t e sum. T h i s sum must equal $EO f o r t h e 
E-F ROM and $CO f o r t h e C - D 
ROM. I f t h e checksum i s n o t 
c o r r e c t , 
t h e d r i v e goes i n t o an e n d l e s s l o o p t o b l i n k t h e r e d e r r o r l i g h t . 
By t h e way, you can t e l l r o u g h l y where t h e e r r o r was by 
w a t c h i n g 
t h e l i g h t . The l i g h t w i l l b l i n k a number o f 
t i m e s , 
pause, 
t h e n 
r e p e a t t h e p a t t e r n . I f i t b l i n k s t w i c e between pauses, t h e 
e r r o r 
was i n t h e E-F ROM; i f i t b l i n k s t h r e e t i m e s between pauses, 
t h e 
e r r o r was i n t h e C - D ROM ( b l i n k i n g o n l y once bewteen pauses would 
mean t h e r e was an e r r o r i n t e s t i n g 
z e r o 
page 
RAM; 
f o u r 
t i m e s 
would mean an e r r o r w h i l e t e s t i n g t h e r e s t o f RAM). 


Any change i n a ROM's ML code w i l l change 
t h a t 
ROM's 
checksum. 
The checksum t e s t can be 
d e f e a t e d 
e n t i r e l y 
by 
s i m p l y 
p u t t i n g 


NOP's i n p l a c e o f a c o u p l e o f b r a n c h s t a t e m e n t s . The code f o r t h e 
ROM checksum i s i n t h e E-F ROM 
a t 
$EAC9-E9. 
The 
l o c a t i o n s 
t o 
change a r e g i v e n f i g u r e 16-1. I f y o u r ROM 
copy 
i s i n t h e 
C64 
s t a r t i n g a t $2000, t h e number 
i n p a r e n t h e s e s 
t e l l s 
where 
t h e 
c o r r e s p o n d i n g l o c a t i o n w i l l be i n C64 memory. 


F i g u r e 16-1: 
DISABLE ROU CHECKSUU 


LOCATION 
(C64 LOC.) 
CONTENTS 
CHANGE TO 


Note t h a t t h e checksum r o u t i n e f o r both ROMs i s i n t h e 
E-F 
ROM. 
I f you want t o d i s a b l e t h e checksum t e s t , y o u ' l l have 
t o m o d i f y 
t h e E-F ROM even i f a l l y o u r o t h e r changes a r e 
i n t h e 
C - D 
ROM 
o n l y . F o r t u n a t e l y , you d o n ' t HAVE 
t o d i s a b l e 
t h e 
r o u t i n e . 
By 
s i m p l y a d j u s t i n g a b y t e i n t h e C - D ROM, 
y o u can make t h e checksum 
come o u t t o t h e p r o p e r v a l u e . You o n l y need t o a d j u s t 
one 
b y t e , 
and any b y t e w i l l do. The v e r y f i r s t b y t e 
o f 
t h e 
C - D 
ROM 
( a t 


$C000) i s a s c r a p 
b y t e 
t h a t 
Commodore 
i t s e l f 
uses 
f o r 
t h i s 
purpose. However, some programs check t h e v a l u e o f t h i s b y t e as a 
way o f d e c i d i n g whether 
t h e 
d r i v e 
i s a 
1541 
o r 
n o t . 
O t h e r 
programs may check t h i s b y t e t o see i f y o u 
have 
m o d i f i e d 
y o u r 
DOS. I t i s p r o b a b l y b e s t t o use some o t h e r b y t e i n t h e $C000-COFF 
area, which i s a l l unused f i l l e r b y t e s ( $ A A 1 s ) . Now a l l y o u 
need 
t o know i s what v a l u e t o p u t t h e r e . 
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You can u s e t h i s same t e c h n i q u e t o add o t h e r commands t o t h e DOS. 
J u s t u s e a d i f f e r e n t t h i r d c h a r a c t e r i n t h e UO command 
f o r 
each 
one. The new 1571 
d r i v e 
has 
s e v e r a l 
new 
commands 
w h i c h 
a r e 
accessed t h r o u g h t h e UO command t h i s way. 
You m i g h t a l s o want 
t o 
i n t e r c e p t o t h e r U commands such as U1 and U2. By 
a l t e r i n g 
o t h e r 
v e c t o r s i n t h e same area, y o u c a n i n t e r c e p t commands such as 
M-W 
and M-R. 
See INSIDE COMMODORE DOS ( p . 433) f o r h e l p 
i n l o c a t i n g 
t h e v e c t o r s f o r o t h e r commands. 


The BUMP COMMANDS r o u t i n e i s l o c a t e d a t $FF30 i n memory, b u t 
t h e 
f i l e on t h e p r o g r a m d i s k l o a d s i n a t $3F30 t o make 
b u r n i n g 
t h e 
EPROM c o p y e a s i e r . I f y o u r c o p y o f t h e E-F ROM s t a r t s a t $2000 i n 
t h e C64, t h e n t h e BUMP COMMANDS f i l e w i l l 
l o a d 
r i g h t 
i n t o 
t h e 
c o r r e c t p o s i t i o n w i t h i n it. F i g u r e 16-4 shows t h e 
C64 
l o c a t i o n s 
c o r r e s p o n d i n g t o t h e U command v e c t o r i n t h i s case. D o n ' t 
f o r g e t 
t o d i s a b l e t h e ROM checksum t o o . Now l e t ' s see how t o r e p l a c e t h e 
DOS ROM c h i p s , s t a r t i n g w i t h m a k i n g a c o p y o f t h e ROM t o d i s k . 


The ROM c h i p s a r e l o c a t e d n e a r t h e r e a r 
o f 
t h e 
1541 ' s 
c i r c u i t 
b o a r d 
n e a r 
t h e 
diamond-shaped 
h e a t 
s i n k s , 
j u s t 
b e h i n d 
t h e 
m i c r o p r o c e s s o r ( a 4 0 - p i n c h i p w h i c h may o r may 
n o t 
be 
l a b e l l e d 
MOS 
6502). 
N o t e 
t h a t 
t h e 
ROMs 
a r e 
2 4 - p i n 
c h i p s . 
A 
p i n - f o r - p i n - c o m p a t i b l e EPROM i s a v a i 1 a b l e , c a l l e d an 
MCM 
68764. 
These c h i p s a r e f a i r l y e x p e n s i v e , even w i t h 
c h i p 
p r i c e s 
coming 
down a l m o s t d a i l y . However, y o u c a n 
u s e 
an 
i n e x p e n s i v e 
2 8 - p i n 
2764 EPROM i n s t e a d o f t h e 68764 i f y o u a l s o u s e 
a 
2 8 / 2 4 - p i n 
AD 
a d a p t o r ( a v a i l a b l e f r o m CSM). The c o s t f o r t h e AD and t h e 2764 i s 
s t i l l a b o u t h a l f t h e c o s t o f t h e 68764 a l o n e . 


O f c o u r s e , b e f o r e y o u c a n r e p l a c e y o u r ROMs y o u have t o 
b e 
a b l e 
t o remove them f i r s t . The E-F ROM i s s o c k e t e d 
on 
a l m o s t 
e v e r y 
d r i v e , b u t most d r i v e s do n o t have a s o c k e t on t h e 
C - D 
ROM. 
We 
d o n ' t recommend t h a t y o u t r y t o remove an 
u n s o c k e t e d 
c h i p 
f r o m 
t h e b o a r d u n l e s s y o u have a 
l o t 
o f 
e x p e r i e n c e 
i n d e s o l d e r i n g 
c h i p s ( a n d some s p a r e c a s h f o r a n o t h e r d r i v e j u s t i n c a s e ! ) . 


The E-F ROM has had 5 d i f f e r e n t v e r s i o n s t o d a t e . T h e r e 
i s o n l y 
one v e r s i o n o f t h e C - D ROM f r o m t h e e a r l i e s t 1541 d r i v e s w i t h t h e 
w h i t e c a s e t o t h e l a t e s t " f l i p - l e v e r " models. The v e r s i o n 
number 
o f t h e ROM f o l l o w s t h e dash a f t e r t h e Commodore 
p a r t 
number 
on 
t h e c h i p . F o r t h e E-F ROM, 
v e r s i o n 5 w o u l d be l a b e l e d 
901229-05. 
The C - D ROM i s l a b e l e d 325302-01. I f y o u a r e g o i n g t o m o d i f y 
t h e 
DOS, 
y o u s h o u l d s t a r t w i t h a c o p y o f v e r s i o n 5 o f t h e E-F ROM. 


T h e r e a r e t w o ways t o r e a d o u t t h e c o n t e n t s o f t h e ROMs 
so 
t h a t 
y o u c a n make changes t o t h e code. The f i r s t i s t o 
u s e 
a 
d r i v e 
m o n i t o r such as DRVMON64 
f r o m 
DI-SECTOR. 
T h i s 
a l l o w s 
y o u 
t o 
examine d r i v e memory, and more i m p o r t a n t l y , t r a n s f e r i t t o 
t h e 
C64. We recommend t h a t y o u t r a n s f e r 
t h e 
c o n t e n t s 
o f 
each 
ROM 
s e p a r a t e l y and 
save 
them 
i n s e p a r a t e 
f i l e s 
f o r 
c o n v e n i e n c e 
( d e p e n d i n g on t h e changes y o u w i s h t o make, y o u may need t o a l t e r 
o n l y one of t h e ROMs). The f o l l o w i n g command 
c a n 
b e 
used 
f r o m 
DRVMON t o t r a n s f e r t h e C - D ROM t o $2000-3FFF i n t h e C64: 


TD COO0 DFFF 2000 
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To t e s t t h e changes g i v e n 
above, 
f i n d 
a 
p i e c e 
o f 
commercial 
s o f t w a r e t h a t bumps t h e d r i v e when i t l o a d s i n . 
Another 
way 
t o 
t e s t t h e bump i s t o t r y t o r e a d an u n f o r m a t t e d d i s k 
w i t h 
a 
TIS 


e d i t o r . S t a r t b y t u r n i n g t h e d r i v e on. Load i n t h e program o r t r y 
t o r e a d t h e u n f o r m a t t e d d i s k . The bump s h o u l d have been 
d i s a b l e d 
a l r e a d y on powerup, so you s h o u l d n ' t h e a r any bump. Now send 
t h e 
d r i v e t h e new UO+ command t o e n a b l e t h e bump: 


OPEN 15,8,15,"UO+" 
:CLOSE15 


T r y t h e e r r o r a g a i n - t h e d r i v e 
s h o u l d 
bump 
now 
( o u c h ! ) . 
Now 
d i s a b l e t h e bump once a g a i n w i t h t h e new U O - command: 


OPEN 15,8,15,"UO-" 
:CLOSE15 


T r y t h e e r r o r one more t i m e . NO BUMP! 


As u s u a l , t h i s c h a p t e r was 
designed 
t o 
g e t 
you 
t h i n k i n g 
and 
e x p e r i m e n t i n g on y o u r own. Good l u c k ! 


EPROM HANDBOOK 
MODIFYING THE 1541 DOS 
PAGE 114 


The program 
d i s k 
w i t h 
t h i s 
book 
c o n t a i n s 
a 
program 
c a l l e d 
"CHECKSUM DOS" ( s e e f i g u r e 1 6 - 2 ) . T h i s r o u t i n e w i l l checksum y o u r 
C - D ROM copy i f i t i s l o c a t e d 
a t 
$2000-3FFF 
i n t h e 
computer. 
S t a r t b y l o a d i n g t h e C - D ROM i n t o t h i s area. 
Next, 
change 
y o u r 
s c r a p b y t e t o $00 
( t h i s 
makes 
c a l c u l a t i n g 
i t s c o r r e c t 
v a l u e 
e a s i e r - always do t h i s ! ) . Load 
t h e 
CHECKSUM 
DOS 
r o u t i n e 
and 
e x e c u t e i t w i t h 
6 1000 
f r o m 
t h e 
m o n i t o r . 
The 
r o u t i n e 
w i l l 
c a l c u l a t e t h e c u r r e n t checksum and p u t i t i n memory l o c a t i o n $FD. 


Figure 1 6 - 2 : 
CHECKSUM DOS ROUTINE 


. I 0 0 0 
A9 20 
LDA #$20 
H i b y t e , s t a r t o f DOS c o p y 


. I 0 0 2 
85 FC 
STA $FC 


. I 0 0 4 
A9 00 
LDA #BOO 
L o b y t e , 
" 
" 
" 
" 
" 
" 


. I 0 0 6 
85 FB 
STA $FB 


. I 0 0 8 
A8 
TAY 
Z e r o i n d e x ( a n d checksum) 


. I 0 0 9 
A2 20 
LDX #$20 
No. pages t o checksum 


. I 0 0 8 
18 
CLC 
S t a r t w i t h c a r r y c l e a r 


. l O O C 
71 FB 
ADC ($FB),Y 
Add n e x t b y t e t o checksum 


.100E 
C8 
I N Y 


.100F 
DO FB 
BNE $100C 
Branch t o do n e x t b y t e 


. I 0 1 1 
E6 FC 
I N C $FC 
N e x t page 


. I 0 1 3 
C A 
D E X 
Decrement page c o u n t 


. I 0 1 4 
DO F6 
BNE $100C 
Branch t o do n e x t page 


. I 0 1 6 
69 00 
ADC #$00 
Add i n l a s t c a r r y 


. I 0 1 8 
85 FD 
STA $FD 
S t o r e checksum 


.101A 
00 
BRK 


Suppose t h a t t h e c u r r e n t checksum comes o u t t o $BO 
r a t h e r 
t h a n 
$CO ( w i t h y o u r s c r a p b y t e s e t t o $ 0 0 ! ) . 
S i n c e t h e checksum i s $10 
t o o low, a l l y o u have t o do i s u s e $10 r a t h e r t h a n 
$00 
f o r 
t h e 
s c r a p b y t e . I n o t h e r 
words, 
t a k e 
t h e 
p r o p e r 
v a l u e 
$CO 
and 
s u b t r a c t t h e c u r r e n t v a l u e ($BO i n t h i s c a s e ) . The r e s u l t w i l l be 
t h e c o r r e c t s c r a p b y t e v a l u e . You 
may 
use 
t h e 
M I C R O M O N / H E S M O N 


s u b t r a c t command t o do t h e s u b t r a c t i o n i f y o u 
w i s h . 
S i n c e 
t h e 
s u b t r a c t command e x p e c t s t h e v a l u e s t o be 
t w o 
b y t e s 
each, 
y o u 
have t o p u t a $00 b y t e i n f r o n t o f each v a l u e : 
- O O C O OOBO 


The m o n i t o r w i l l g i v e t h e r e s u l t $0010. 
I g n o r e t h e $00 
b y t e 
and 
j u s t use t h e $10. What happens i f t h e c u r r e n t checksum i s LARGER 
t h a n 
$CO, 
say 
$DO? 
Do 
t h e 
s u b t r a c t i o n 
i n t h e 
same 
o r d e r 


( - O O C O OODO). Y o u ' l l g e t a s t r a n g e l o o k i n g 
r e s u l t , 
$FFFO. 
The 
h i g h b y t e of t h e r e s u l t , $FF, 
i s j u s t 
a 
way 
o f 
r e p r e s e n t i n g 
n e g a t i v e numbers ( s i n c e y o u s u b t r a c t e d 
a 
l a r g e r 
v a l u e 
f r o m 
a 
s m a l l e r one). When t h i s happens, t a k e t h e l o w b y t e o f t h e 
r e s u l t 


($FO i n t h i s c a s e ) and subtract 1 from i t . O n l y do 
t h i s i f t h e 
h i g h b y t e i s $FF. T h i s p r o c e s s w i l l g i v e y o u 
t h e 
c o r r e c t 
s c r a p 
b y t e v a l u e ( i n t h i s case, $EF). 
You 
s h o u l d 
always 
check 
y o u r 
s c r a p v a l u e by p u t t i n g i t i n t h e ROM i n p l a c e 
o f 
t h e 
$00 
and 
r u n n i n g t h e checksum a g a i n . It s h o u l d g i v e t h e 
r e s u l t 
$CO 
w i t h 
t h e new s c r a p v a l u e . You can a l s o u s e t h i s 
p r o c e d u r e 
t o 
a d j u s t 
t h e checksum f o r t h e E-F ROM. 
P i c k a b y t e f r o m one o f t h e 
unused 
areas i n f i g u r e 16-3 f o r y o u r s c r a p b y t e . 
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To d e m o n s t r a t e m o d i f y i n g t h e DOS, w e ' l l add a c o u p l e o f 
f e a t u r e s 
t o t h e DOS t h a t e v e r y o n e can use. As y o u may 
know, 
t h e r e 
i s a 
l o c a t i o n i n t h e 1 5 4 1 ' s memory t h a t c o n t r o l s whether 
o r 
n o t 
t h e 
d r i v e w i l l do a "bump" when i t e n c o u n t e r s an e r r o r . L o c a t i o n 
$6A 


( 1 0 6 ) , commonly c a l l e d REVCNT, c o n t r o l s t h e 
bump 
f e a t u r e . 
Many 
magazines have 
p u b l i s h e d 
a 
Memory-Write 
(M-W) 
command 
w h i c h 
d i s a b l e s t h e bump b y s e t t i n g REVCNT t o 133 ( $ 8 5 ) . T h a t change 
i s 
o n l y temporary, however. We can do much b e t t e r . 


REVCNT i s i n i t i a l i z e d t o $05 ( b i n a r y %0000 0101) 
by 
a 
powerup, 


RESET, UJ o r U I comand. S e t t i n g b i t 7 o f REVCNT t o a 1 i n s t e a d o f 
a 0 w i l l d i s a b l e t h e bump. T h i s change w i l l n o t a f f e c t 
t h e 
bump 
r e q u i r e d t o f o r m a t a d i s k . S i n c e t h e normal v a l u e 
o f 
REVCNT 
i s 
$05, s e t t i n g b i t 7 t o d i s a b l e t h e bump g i v e s 
us 
t h e 
v a l u e 
$85 
(133) i n s t e a d . REVCNT i s i n i t i a l i z e d by t h e code a t 
$EBDl-D4 
i n 
t h e U I command, w h i c h i s c a l l e d on powerup, e t c . A l l we 
have 
t o 
do i s change t h e v a l u e p l a c e d i n REVCNT t o $85 and t h e bump 
w i l l 
be a u t o m a t i c a l l y d i s a b l e d . S p e c i f i c a l l y , 
t o d i s a b l e 
t h e bump, 
change l o c a t i o n $EBD2 f r o m an $05 t o an $85. I f y o u r ROM copy 
i s 
l o c a t e d a t $2000 i n t h e computer, t h i s b y t e w i l l be a t $2BD2. 


Remember, a l l we a r e d o i n g i s c h a n g i n g t h e v a l u e t h a t i s p u t 
i n 
REVCNT d u r i n g i n i t i a l i z a t i o n . You can change t h i s v a l u e 
back 
t o 
t h e d e f a u l t v a l u e and r e - e n a b l e t h e bump any t i m e y o u w i s h . 
J u s t 
t y p e i n t h e f o l l o w i n g commands: 


OPEN 15,8,15 
PRINT#15, 
"M-W" 
CHR$(106) CHR$(O) C H R $ ( l ) CHR$(5) 


CLOSE 15 


Why would y o u WANT t o r e - e n a b l e t h e bump? W e l l , some o f t h e newer 
p r o t e c t i o n schemes may l e a v e t h e head o f f - t r a c k 
a f t e r 
t h e y 
a r e 
f i n i s h e d . When t h i s happens, even t u r n i n g 
t h e 
power 
o f f 
w o n ' t 
u s u a l l y c o r r e c t i t . An I 0 command may g e t t h e head back on t r a c k , 
b u t more o f t e n a bump i s r e q u i r e d . You can u s e 
t h e 
M-W 
command 
above t o r e - e n a b l e t h e bump, b u t 
t h a t 
command 
i s n o t 
e x a c t l y 
c o n v e n i e n t t o remember. How about i f we add a command t o t h e 
DOS 
t o e n a b l e ( o r d i s a b l e ) t h e head bump? 


W e ' l l do t h i s t h r o u g h t h e USER command UO. The new commands 
w i l l 
be: 


UO+ 
E n a b l e bump 
UO- 
D i s a b l e bump 


The " U " commands a r e h a n d l e d b y a r o u t i n e l o c a t e d a t $CB5C i n t h e 
DOS. T h i s r o u t i n e i s r e a c h e d t h r o u g h a v e c t o r 
i n t h e 
E-F 
ROM. 
F i r s t w e ' l l change t h e v e c t o r t o p o i n t t o an unused a r e a ($FF30), 
where w e l l 1 p u t a s p e c i a1 r o u t i n e o f 
o u r 
own. 
Whenever 
any 
U 
command i s executed, t h e DOS w i l l go t o o u r 
r o u t i n e 
f i r s t . 
Our 
r o u t i n e w i l l i n t e r c e p t t h e new commands 
and 
p e r f o r m 
them. 
A11 


o t h e r U commands w i l l be passed a l o n g t o t h e normal r o u t i n e s t h a t 
h a n d l e them. Our r o u t i n e i s l i s t e d i n f i g u r e 16-4. The r o u t i n e i s 
on 
t h e 
d i s k 
accompanying 
t h i s 
book, 
under 
t h e 
name 
"BUMP 
COMMANDS". 
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FREEZE CARTRIDGE 


The FREEZE c a r t r i d g e d e s c r i b e d i n t h i s c h a p t e r i s a handy u t i l i t y 
f o r examining and d e b u g g i n g programs. It a l l o w s y o u 
t o 
" f r e e z e " 
t h e c o m p u t e r ' s memory a t any p o i n t so y o u 
can 
examine 
i t w i t h 
y o u r ML 
m o n i t o r . 
You 
s h o u l d 
n o t 
c o n f u s e 
o u r 
s i m p l e 
FREEZE 
c a r t r i d g e w i t h o t h e r c o m m e r c i a l 
p r o d u c t s 
such 
as 
SNAPSHOT 64. 
SNAPSHOT 64, w h i c h i s d i s t r i b u t e d e x c l u s i v e l y i n t h e U.S. 
b y CSM, 


saves a b o u t as much o f memory as i t i s p o s s i b l e 
t o 
p r e s e r v e , 
compacts i t and e l i m i n a t e s t h e unused 
a r e a s . 
SNAPSHOT 64 
saves 
t h e 
compressed 
memory 
t o 
d i s k 
and 
adds 
on 
an 
a u t o - b o o t 
a u t o m a t i c a l l y , so t h a t i n most cases t h e p r o g r a m c a n a c t u a l l y 
be 
r e s t a r t e d a t e x a c t l y t h e 
same 
p o i n t i t was 
i n t e r r u p t e d . 
Our 
s i m p l e FREEZE c a r t r i d g e m e r e l y 
c o l l e c t s 
some 
u s e f u l 
a r e a s 
o f 
memory and t h e p r o c e s s o r i n t o a more a c c e s i b l e a r e a o f memory f o r 
y o u r exami n a t i on. 


W i t h o u t a FREEZE c a r t r i d g e 
o r 
s i m i l a r 
u t i l i t y y o u 
can 
s t i l l 
u s u a l l y 
examine 
m o s t 
o f 
memory 
a f t e r 
s i m p l y 
RESETing 
t h e 
computer. However, RESET r e - i n i t i a l i z e s l o w memory 
($0000-07FF), 


t h e 1 / 0 d e v i c e s ( V I C and CIA c h i p s ) and c o l o r 
RAM 
($D800-DBFF). 


The RESET p r o c e s s a l s o p u t s an a n n o y i n g $55 b y t e a t e i t h e r 
$8000 
o r $A000 ( s e e t h e AUTOSTART CARTRIDGES c h a p t e r f o r an e x p l a n a t i o n 
about t h i s $55 b y t e ) . I f y o u want t o f i n d o u t 
what 
t h e s e 
a r e a s 
c o n t a i n e d w h i l e a p r o g r a m was r u n n i n g , y o u 
must 
use 
a 
s p e c i a l 
u t i l i t y such as o u r FREEZE c a r t r i d g e . 
F o r 
c o n v e n i e n c e , 
a n o t h e r 
f e a t u r e was b u i l t i n t o t h e 
FREEZE 
c a r t r i d g e : 
i t a u t o m a t i c a l l y 
c o p i e s t h e c o n t e n t s o f a l l " h i d d e n " RAM down t o more 
a c c e s s i b l e 
areas. Hidden RAM r e f e r s t o t h e RAM w h i c h l i e s 
under 
t h e 
BASIC 
and KERNAL 
ROMS 
and 
1 / 0 
d e v i c e s . 
F i n a l l y , 
u n d e r 
t h e 
r i g h t 
c o n d i t i o n s , t h e FREEZE c a r t r i d g e can even p r e s e r v e 
t h e 
c o n t e n t s 
of t h e 6 5 1 0 ' s r e g i s t e r s , i n c l u d i n g t h e A, 
X, 
Y, 
s t a c k 
p o i n t e r 


(SP), s t a t u s r e g i s t e r (SR) and t h e p r o g r a m c o u n t e r ( P C ) ! ! 


The FREEZE c a r t r i d g e w o r k s b y c o p y i n g t h e a r e a s o f memory 
t o 
be 
p r e s e r v e d i n t o t h e $2000-7FFF area, and t h e n r e t u r n i n g c o n t r o l o f 
t h e computer t o you. A f t e r l o a d i n g i n a m o n i t o r y o u 
can 
examine 
and save t h e " f r o z e n " memory. F i g u r e 17-1 shows where 
i n memory 
each p r e s e r v e d s e c t i o n i s l o c a t e d . 


The l o w memory a r e a ($0000-0800) 
w i l l 
b e 
c o m p l e t e l y 
p r e s e r v e d 
e x c e p t f o r a f e w b y t e s o f t h e s t a c k as e x p l a i n e d below. The c o l o r 
RAM ($D800-DBFF) and h i d d e n RAM ($A000-BFFF and $D000-FFFF) 
w i l l 
be p r e s e r v e d e x a c t l y . FREEZE 
a l s o 
saves 
t h e 
c o n t e n t s 
o f 
t w o 
i m p o r t a n t RAM b y t e s , $0800 
and $8000. R e g a r d l e s s o f how 
i t was 
e n t e r e d , FREEZE t e r m i n a t e s b y g o i n g t h r o u g h 
t h e 
RESET 
p r o c e s s . 
T h i s w i l l p l a c e a $00 b y t e a t $0800 ( f o r BASIC 
p r o g r a m s ) 
and 
a 
$55 a t $8000 ( a s p a r t o f t h e RAM t e s t r o u t i n e ) . FREEZE 
p r e s e r v e s 
t h e c o n t e n t s o f t h e s e t w o b y t e s b e f o r e t h e RESET p r o c e s s i n case 
y o u need t o know what t h e y were. 
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Fiaure 17-1: FREEZE CARTRIDGE TABLE 


ORIGINAL AREA 
SAVED AT 


** Breakdown o f t h e $2F00 a r e a : 


DESCRIPTION 


Low memory i n c l u d i n g s c r e e n 
C o l o r RAM 
CIA # 1 ( p l u s images) 
CIA # 2 
" 
" 
" 
" 


V I C I 1 " 
" 
" 
" 


P r o c e s s o r r e g i s t e r s , e t c . 
RAM u n d e r BASIC ROM 


11 
11 
I1 
1 / 0 d e v i c e s 


11 
11 
11 
KERNAL ROM 


00 
PC 
Program C o u n t e r H i g h 
0 1 


11 
11 
11 
11 
11 
Low 
02 
A 
A - r e g i s t e r 
03 
X 
X - r e g i s t e r 
04 
Y 
Y - r e g i s t e r 
05 
SR 
S t a t u s R e g i s t e r 
06 
SP1 
S t a c k p o i n t e r ( o r i g ) 
i 


07 
SP2 
" 
" 
" 
( c u r r e n t ) 
08 
0800 O r i g i n a l c o n t e n t s 
09 
8000 
ll 
ll 
ll 
ll 
ll 


P r o c 
B i t 
T 


1 
2 
3 
4 
5 
6 
7 


S t a t u s 


E % y 
Z e r o 
I R Q D i s a b l e 
Decimal Mode 
B r e a k 
N o t used 
O v e r f 1 ow 
N e g a t i v e 


W i t h r e g a r d t o t h e 1 / 0 d e v i c e s , o n l y t h e READ 
r e g i s t e r s 
o f 
t h e 
CIA and V I C c h i p s 
w i l l 
be 
p r e s e r v e d . 
These 
c h i p s 
have 
some 
r e g i s t e r s w h i c h c a n 
o n l y 
be 
w r i t t e n 
t o , 
o r 
w h i c h 
r e t u r n 
a 
d i f f e r e n t v a l u e when r e a d t h a n what was w r i t t e n t h e r e . 
O n l y 
t h e 
v a l u e s r e t u r n e d when t h e c h i p i s r e a d w i l l be saved. A l s o , 
s i n c e 
each o f t h e s e c h i p s has o n l y a f e w r e g i s t e r s and y e t 
o c c u p i e s 
a 
w h o l e page o f memory ( 2 5 6 b y t e s ) , "images" 
o f 
t h e 
c h i p 
appear 
t h r o u g h o u t t h e memory page. F o r t h e most p a r t 
t h e s e 
images 
a r e 
i d e n t i c a l t o t h e o r i g i n a l ( t h e f i r s t c o p y ) , b u t c e r t a i n r e g i s t e r s 
such as t i m e r s may be 
d i f f e r e n t 
because 
o f 
t h e 
t i m e 
between 
r e a d i n g one image and t h e n e x t . T h i s may t i p y o u 
o f f 
t h a t 
t h e 
program y o u ' r e i n v e s t i g a t i n g 
e n a b l e s 
a 
p a r t i c u l a r 
t i m e r , 
f o r 
example. By t h e way, 
no a t t e m p t i s made t o p r e s e r v e t h e SID 
c h i p 
because a l m o s t a l l o f i t s r e g i s t e r s 
a r e 
WRITE-ONLY. 
O n l y 
f o u r 
r e g i s t e r s a r e READable, and t h e s e a r e o f l i t t l e o r no use w i t h o u t 
t h e o t h e r s . 


The 6 5 1 0 ' s r e g i s t e r s may o r may n o t be 
p r e s e r v e d , 
d e p e n d i n g 
on 
how t h e FREEZE c a r t r i d g e i s a c t i v a t e d ( t h e d i f f e r e n t methods 
a r e 
d i s c u s s e d b e l o w ) . On RESET t h e c o n t e n t s w i l l be l o s t , b u t i n a l l 
o t h e r c a s e s t h e y w i l l be saved. The A, 
X 
and 
Y 
r e g i s t e r s 
a r e 
p r e s e r v e d i n t a c t . The p r o g r a m c o u n t e r (PC) w i l l i n d i c a t e t h e n e x t 
i n s t r u c t i o n t o be EXECUTED, w h i c h i s n o t 
n e c e s s a r i l y 
t h e 
n e x t 
i n s t r u c t i o n 
i n s e q u e n t i a l 
o r d e r . 
F o r 
example, 
i f t h e 
l a s t 
i n s t r u c t i o n e x e c u t e d was a JSR, 
t h e PC w i l l c o n t a i n t h e 
l o c a t i o n 
o f t h e SUBROUTINE, 
n o t t h e s t a t e m e n t a f t e r t h e 
JSR 
i n s t r u c t i o n . 
By t h e way, t h e FREEZE c a r t r i d g e r e c o r d s t h e PC 
i n $2F00-01 
i n 
h i - b y t e / l o - b y t e o r d e r , r a t h e r t h a n t h e u s u a l r e v e r s e d o r d e r . 
A 
PC a d d r e s s o f $2000 w o u l d be r e c o r d e d as 20 00 r a t h e r t h a n 00 20. 
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A s l i g h t d i s c r e p a n c y 
i n t h e 
PC 
v a l u e 
o c c u r s 
w i t h 
d i f f e r e n t 
methods f o r e n t e r i n g FREEZE, due t o t h e w o r k i n g s o f t h e 6502/6510 
p r o c e s s o r . The PC v a l u e p l a c e d o n t h e s t a c k b y t h e 
p r o c e s s o r 
i s 
d i f f e r e n t w i t h t h e JSR 
(Jump 
t o S u b R o u t i n e ) 
and 
BRK 
(BReaK) 


i n s t r u c t i o n s t h a n w i t h an NMI i n t e r r u p t (Non-Maskable I n t e r r u p t ) . 
The PC v a l u e pushed on t h e s t a c k b y JSR i s t h e 
a d d r e s s 
o f 
t h e 
last byte of the JSR instruction r a t h e r t h a n t h e 
f i r s t 
b y t e 
o f 
t h e n e x t i n s t r u c t i o n , 
so i t i s one 
b y t e 
t o o 
l o w 
( t h e 
RTS 
s t a t e m e n t compensates f o r 
t h i s 
b y i 
n c r e m e n t i ng 
t h e 
PC 
v a l u e 
p u l l e d o f f t h e s t a c k b e f o r e u s i n g i t ) . Thus t h e PC 
w i l l 
be 
one 
byte too low when JSR i s used t o e n t e r FREEZE. 


The BRK i n s t r u c t i o n , on t h e o t h e r hand, s t a r t s w i t h 
a 
PC 
v a l u e 
equal t o t h e l o c a t i o n o f t h e BRK 
i n s t r u c t i o n 
i t s e l f , 
b u t 
t h e n 
i n c r e m e n t s t h e PC twice b e f o r e p u s h i n g i t on t h e 
s t a c k . 
I n s t e a d 
o f p o i n t i n g t o t h e n e x t b y t e i m m e d i a t e l y a f t e r BRK, t h e PC 
s k i p s 
a b y t e and p o i n t s t o t h e second b y t e a f t e r BRK. T h i s means t h e PC 
w i l l be one byte too high when 
BRK 
i s used 
t o 
e n t e r 
FREEZE. 
F i n a l l y , an N M I i n c r e m e n t s t h e PC o n l y once b e f o r e p u s h i n g i t on 
t h e s t a c k , so t h e PC p o i n t s r i g h t t o t h e n e x t i n s t r u c t i o n 
t o 
be 
executed. Thus t h e PC w i l l be exactly correct when an NU1 i s u s e d 
t o e n t e r FREEZE. An NMI ( v i a t h e RESTORE k e y ) i s t h e most 
common 
method o f e n t e r i n g FREEZE, s o m o s t o f t h e t i m e 
t h e 
PC 
w i l l 
be 
e x a c t l y c o r r e c t . 


As f a r as t h e o t h e r 6510 
r e g i s t e r s 
a r e 
concerned, 
t h e 
s t a t u s 
r e g i s t e r (SR) w i l l b e saved i n t a c t e x c e p t when FREEZE i s e n t e r e d 
t h r o u g h RESET and BRK. RESET w i l l w i p e o u t t h e SR e n t i r e l y , w h i l e 
BRK w i l l j u s t change t h e BRK f l a g t o a 
"1". 
The 
s t a c k 
p o i n t e r 


(SP) i s a l t e r e d when y o u e n t e r FREEZE, b u t t h e o r i g i n a l v a l u e c a n 
be r e c o v e r e d ( e x c e p t w i t h RESET). B e f o r e t h e FREEZE c a r t r i d g e 
i s 
e n t e r e d , some v a l u e s a r e pushed on t h e 
s t a c k , 
w h i c h 
decrements 
t h e SP and w i p e s o u t a f e w b y t e s o f s t a c k memory. By p u l l i n g 
t h e 
c o r r e c t number o f i t e m s back o f f t h e s t a c k , t h e SP i s r e s t o r e d t o 
i t s o r i g i n a l v a l u e . The s t a c k memory b y t e s c a n n o t 
b e 
r e c o v e r e d , 
however. FREEZE p r e s e r v e s b o t h t h e o r i g i n a l v a l u e 
o f 
SP 
b e f o r e 
a n y t h i n g was pushed on t h e 
s t a c k , 
and 
i t s a c t u a l 
v a l u e 
when 
FREEZE was e n t e r e d , a f t e r t h e v a l u e s were pushed 
on 
t h e 
s t a c k . 
The a r e a o f t h e s t a c k f r o m 
t h e 
o r i g i n a l 
SP 
down 
t o 
b u t 
n o t 
i n c l u d i n g t h e second SP v a l u e w i l l 
have 
been 
w i p e d 
o u t . 
When 
u s i n g t h e NMI e n t r y (RESTORE k e y ) , t w o more b y t e s s t a r t i n g a t t h e 
second SP v a l u e w i l l be w i p e d o u t t o o . 


P u t t i n g t h e FREEZE c a r t r i d g e on 
EPROM 
i s easy. 
T u r n 
o f f 
t h e 
computer and p l u g i n t h e PROMENADE. 
Load i n PROMOS 
and 
r u n it. 
Load i n t h e f i l e c a l l e d 
"FREEZE" 
f r o m 
t h e 
p r o g r a m 
d i s k . 
The 
FREEZE p r o g r a m n o r m a l l y r e s i d e s a t $8000-FF, 
b u t t h e 
f i l e 
l o a d s 
i n a t $2000-FF f o r c o n v e n i e n c e . I n s e r t a 2764 EPROM ( 8 K ) i n t o t h e 
PROMENADE ( n o t c h t o t h e l e f t ) and l o c k down t h e h a n d l e . Now 
t y p e 
t h e f o l l o w i n g PROMOS command: 


S i n c e t h e program t a k e s l e s s 
t h a n 
256 
b y t e s , 
y o u 
c a n 
use 
a 
s m a l l e r EPROM i n s t e a d o f t h e 2764, such as a 2732 
( 4 K ) 
o r 
2716 


( 2 K ) . 
C o n s u l t 
t h e 
PROMENADE 
manual 
f o r 
t h e 
a p p r o p r i a t e 
CW 
( c o n t r o l w o r d ) and PW 
( p r o g r a m w o r d ) . 
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Now y o u m u s t s e t 
up 
y o u r 
c a r t r i d g e 
b o a r d 
as 
a 
s t a n d a r d 
8K 
c a r t r i d g e . T h i s means t h a t t h e c a r t r i d g e s h o u l d g r o u n d 
o n l y 
t h e 
EXROM l i n e . Make s u r e t h e c a r t r i d g e b o a r d j u m p e r s a r e s e t s o t h a t 
p i n 9 o f t h e c a r t r i d g e p o r t (EXROM) i s c o n n e c t e d 
t o t h e 
g r o u n d 
l i n e , b u t p i n 8 (GAME) i s n ' t . I n s e r t t h e EPROM i n t o t h e c a r t r i d g e 
b o a r d and y o u ' r e a l l s e t . Depending on y o u r c a r t r i d g e board, 
y o u 
may have t o change some o t h e r j u m p e r s i f y o u a r e u s i n g a 2732 
o r 
2716 r a t h e r t h a n a 2764. 


The FREEZE c a r t r i d g e can be 
a c t i v a t e d 
a 
number 
o f 
ways. 
One 
method may b e b e t t e r s u i t e d t h a n t h e o t h e r s f o r t h e 
p r o g r a m 
y o u 
a r e i n v e s t i g a t i n g , 
d e p e n d i n g 
on 
how 
and 
where 
y o u r 
p r o g r a m 
e x e c u t e s . The v a r i e t y o f 
methods 
may 
seem 
c o n f u s i n g , 
b u t 
i n 
p r a c t i c e y o u ' l l u s u a l l y o n l y use one o r t w o most o f t h e t i m e . A l l 
o f t h e methods p r e s e r v e p r e t t y much t h e same RAM memory. The main 
d i f f e r e n c e between t h e v a r i o u s methods i s w h e t h e r 
t h e 
p r o c e s s o r 
c o n t e n t s a r e 
p r e s e r v e d 
and 
how 
much 
o f 
t h e 
s t a c k 
w i l l 
be 
d i s t u r b e d . You may a l r e a d y know 
enough 
a b o u t 
y o u r 
p r o g r a m 
t o 
d e c i d e w h i c h method t o use, o r y o u may have t o e x p e r i m e n t t o f i n d 
t h e b e s t method. G e n e r a l l y , y o u ' l l 
need 
a 
c a r t r i d g e 
e x p a n s i o n 


b o a r d ' t n o r d e r t o s w i t c h i n t h e FREEZE c a r t r i d g e 
a t 
t h e 
p r o p e r 
t i m e . A RESET b u t t o n may a l s o be 
r e q u i r e d . 
See 
t h e 
i n d i v i d u a l 
methods b e l o w f o r d e t a i l s . 


RESET 
The FREEZE c a r t r i d g e r e s i d e s a t $8000. The m o s t 
i m p o r t a n t 
q u e s t i o n , as f a r as a c t i v a t i n g FREEZE i s concerned, i s w h e t h e r o r 
n o t y o u r p r o g r a m w i l l be e x e c u t i n g code i n t h e 
$8000-9FFF 
a r e a 
when y o u want t o i n t e r r u p t it. I f i t w i l l be 
e x e c u t i n g 
i n t h i s 
area, y o u must u s e t h e RESET method. HOLD DOWN t h e RESET 
b u t t o n , 
s w i t c h t h e c a r t r i d g e 
on, 
and 
t h e n 
r e l e a s e 
t h e 
b u t t o n . 
T h i s 
p r e v e n t s t h e p r o c e s s o r f r o m e x e c u t i n g any i n s t r u c t i o n s d u r i n g t h e 
t i m e y o u a r e m o v i n g t h e s w i t c h ( e s ) . W i t h RESET y o u ' l l be a b l e 
t o 
p r e s e r v e a l l t h e RAM memory, b u t n o t t h e p r o c e s s o r 
r e g i s t e r s 
o r 
1 / 0 d e v i c e s . The t o p t w o b y t e s o f t h e s t a c k 
($OlFE-FF) 
w i l l 
be 
a l t e r e d t o o . I f y o u d o n ' t 
c a r e 
a b o u t 
t h e 
p r o c e s s o r ' s 
o r 
1 / 0 
d e v i c e s ' c o n t e n t s , RESET i s t h e s i m p l e s t method t o use. 
I f y o u r 
p r o g r a m s w i t c h e s o u t t h e BASIC o r KERNAL ROMs o r t h e 1 / 0 d e v i c e s , 
t h e FREEZE c a r t r i d g e w i l l a l s o be s w i t c h e d o u t . 
Y o u ' l l 
have 
t o 
use t h e RESET method i n t h e s e c a s e s t o o . 


RESTORE 
T h i s 
i s t h e 
m a i n 
method 
f o r 
e n t e r i n g 
t h e 
FREEZE 
c a r t r i d g e . 
I f y o u r 
p r o g r a m 
does 
n o t 
have 
e i t h e r 
o f 
t h e 
l i m i t a t i o n s above, r e q u i r i n g t h e u s e o f RESET, y o u 
can 
p r o b a b l y 
u s e t h e RESTORE key. W a i t u n t i l t h e p r o g r a m r e a c h e s t h e p o i n t 
a t 
w h i c h y o u want t o i n t e r r u p t it, s w i t c h t h e c a r t r i d g e on and p r e s s 
RESTORE. You c a n r e c o v e r a l l o f 
t h e 
p r o c e s s o r ' s 
r e g i s t e r s 
and 
most of t h e CIA and V I C c h i p s ' r e g i s t e r s t h i s way. E i g h t b y t e s o f 
t h e s t a c k w i l l be w i p e d i n t h e p r o c e s s , however. 
These 
w i l l 
be 
t h e n e x t e i g h t unused b y t e s o f t h e s t a c k , s o 
a l l 
o f 
t h e 
s t a c k 
a c t u a l l y used b y t h e 
p r o g r a m 
w i l l 
u s u a l l y 
be 
p r e s e r v e d . 
The 
RESTORE k e y w o r k s b y g e n e r a t i n g an N M I 
(Non-Maskable 
I n t e r r u p t ) 
w h i c h saves t h e p r o c e s s o r ' s c o n t e n t s on t h e s t a c k and t h e n 
jumps 
t o t h e FREEZE c a r t r i d g e 
u s i n g 
t h e 
CBM80 
c a r t r i d g e 
w a r m - s t a r t 
v e c t o r a t $8002. 
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The RESTORE k e y has one q u i r k - i t t e n d s t o "bounce". 
As 
y o u ' v e 
p r o b a b l y n o t i c e d b y now, y o u u s u a l l y have t o H I T t h e RESTORE 
k e y 
r a t h e r t h a n j u s t PRESS i t t o g e t i t t o r e s p o n d . I f y o u 
do 
t h i s 
w i t h t h e FREEZE c a r t r i d g e , 
i t w i l l 
o f t e n 
r e s p o n d 
as 
i f y o u 
p r e s s e d t h e RESTORE k e y t w i c e i n a row. The 
f i r s t RESTORE 
w i l l 
s t a r t t h e FREEZE p r o c e s s , 
b u t 
t h e 
second 
w i l l 
i n t e r r u p t 
t h e 
p r o c e s s and s t a r t i t a g a i n . 


There a r e t w o ways a r o u n d t h i s p r o b l e m . T r y p r e s s i n g t h e 
RESTORE 
key s l o w l y . N o t h i n g w i l l happen ( t r y i t ! ) . Now r e l e a s e t h e k e y as 
q u i c k l y as p o s s i b l e - i t s h o u l d c a u s e e x a c t l y one RESTORE 
t o 
be 
r e g i s t e r e d . The o t h e r a l t e r n a t i v e i s t o g e n e r a t e an 
N M I 
t h r o u g h 
hardware. P i n D on t h e c a r t r i d g e p o r t i s t h e N M I l i n e . L o o k i n g a t 
t h e edge o f t h e cartridge w i t h i t r i g h t - s i d e 
up 
( c o m p u t e r ' s - e y e 
v i e w ) , N M I i s t h e f o u r t h p i n f r o m t h e LEFT on t h e BOTTOM row. 
I f 
y o u 
have 
a 
m u l t i - s l o t 
e x a p n s i o n 
board, 
y o u 
can 
use 
t h e 
c o r r e s p o n d i n g p i n on one o f t h e unused s l o t s . 
By 
s h o r t i n g 
t h i s 
p i n t o g r o u n d ( p i n 1, 22, A o r Z) y o u ' l l g e n e r a t e t h e 
e q u i v a l e n t 
o f p r e s s i n g t h e RESTORE key. A s w i t c h 
s h o u l d 
b e 
i n s t a l l e d f o r 
t h i s p u r p o s e i f y o u ' l l b e d o i n g i t o f t e n . You can even mount 
t h e 
s w i t c h r i g h t on t h e FREEZE c a r t r i d g e and t i e i n t o t h e p i n s on t h e 
c a r t r i d g e b o a r d . 


The r e m a i n i n g ways 
t o 
a c t i v a t e 
FREEZE 
r e q u i r e 
m o d i f y i n g 
t h e 
program b e i n g i n v e s t i g a t e d . They a r e u s u a l l y needed o n l y i f t h e 
program a l t e r s normal system v e c t o r s o r m u s t be i n t e r r u p t e d a t 
a 
s p e c i f i c i n s t r u c t i o n . 


NU1 Vector 
The RESTORE k e y o r h a r d w a r e N M I c a u s e s a jump t o 
t h e 
M I r o u t i n e i n t h e KERNAL. The NMI r o u t i n e u s e s a v e c t o r 
i n RAM 
a t $0318-19 t o d e c i d e where t o go n e x t . I f y o u change t h i s v e c t o r 
b e f o r e s t a r t i n g y o u r program, an N M I w i l l jump d i r e c t l y i n t o 
t h e 
FREEZE c a r t r i d g e . However, many programs a l t e r t h e NMI RAM v e c t o r 
when t h e y e x e c u t e , s o t h a t t h e c h e c k f o r a 
CBM80 
a u t o s t a r t 
k e y 
w i l l n o t be done. T h i s w i l l d i s a b l e t h e FREEZE 
c a r t r i d g e , 
s i n c e 
FREEZE 
u s e s 
t h e 
CBM80 
k e y 
t o s t a r t 
i t s e l f 
on 
RESTORE. 
F o r t u n a t e l y , many programs t h a t a l t e r t h e N M I RAM v e c t o r do s o i n 
an o b v i o u s manner n e a r t h e b e g i n n i n g o f t h e b o o t p r o c e s s . You may 
be a b l e t o remove t h e i r N M I v e c t o r v a l u e and r e p l a c e i t w i t h 
t h e 
normal v a l u e ($FE47). B e t t e r y e t , y o u c a n p o i n t t h e N M I 
d i r e c t l y 
i n t o FREEZE b y i n s e r t i n g 
t h e 
v a l u e 
$800B 
i n s t e a d . 
T h i s 
w i l l 
p r e s e r v e a f e w e x t r a b y t e s o f s t a c k memory, and seems t o p r e v e n t 
t h e 
RESTORE 
k e y 
"bounce" 
d i s c u s s e d 
above. 
O t h e r w i s e i t i s 
i d e n t i c a l t o t h e RESTORE method. 


JSR $8009 
I f y o u c a n ' t f i n d where t h e N M I v e c t o r i s changed, 
o r 
i f t h e m o d i f i e d N M I v e c t o r i s n e c e s s a r y f o r t h e o p e r a t i o n o f 
t h e 
program, o r i f y o u need t o i n t e r r u p t t h e p r o g r a m a t a 
p a r t i c u l a r 
i n s t r u c t i o n , y o u may b e a b l e t o u s e a JSR 
t o 
e n t e r 
t h e 
FREEZE 
c a r t r i d g e d i r e c t l y . S i m p l y i n s e r t a JSR $8009 
s t a t e m e n t 
a t 
t h e 
p o i n t where y o u w i s h t o 
i n t e r r u p t 
t h e 
program. 
As 
w i t h 
most 
methods, y o u m u s t e i t h e r be a b l e t o have t h e 
c a r t r i d g e 
s w i t c h e d 
on t h r o u g h o u t t h e w h o l e program, o r a t l e a s t 
be 
a b l e 
t o j u d g e 
f r o m w a t c h i n g t h e p r o g r a m when i t i s ok t o s w i t c h 
t h e 
c a r t r i d g e 
on. T h i s method w i p e s o u t 
o n l y 
t h r e e 
b y t e s 
o f 
s t a c k 
memory. 
Remember, 
t h e PC v a l u e r e c o r d e d b y FREEZE w i l l be 1 b y t e t o o low, 
as d i s c u s s e d above. 
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BRK Vector 
The f i n a l method i n v o l v e s t h e BRK v e c t o r . T h i s 
w o u l d 
o n l y b e used i f y o u j u s t c a n ' t f i t a JSR i n s t r u c t i o n i n t h e 
code 
a t t h e p o i n t r e q u i r e d . A BRK i n s t r u c t i o n ( $ 0 0 ) r e q u i r e s o n l y 
one 
b y t e as opposed t o t h r e e f o r a JSR. 
I n a d d i t i o n t o i n s e r t i n g 
t h e 
BRK i n s t r u c t i o n i n t h e code, y o u ' l l have t o a l t e r t h e normal 
BRK 
RAM v e c t o r a t $0314. Do t h i s b e f o r e 
s t a r t i n g y o u r 
program. 
As 
w i t h t h e N M I v e c t o r , y o u r p r o g r a m may change t h i s v e c t o r 
i t s e l f . 
I f i t does, y o u may be a b l e t o 
s u b s t i t u t e 
y o u r 
own 
v a l u e 
f o r 
t h e i r s . I n any case, u s e t h e v a l u e $8018 f o r t h e BRK v e c t o r . T h i s 
e n t e r s FREEZE a t t h e same p o i n t as t h e N M I methods, 
and 
so 
has 
t h e same c h a r a c t e r i s t i c s , w i t h one e x c e p t i o n . As d i s c u s s e d above, 
t h e PC v a l u e r e c o r d e d b y FREEZE w i l l be one b y t e t o o h i g h . 


F i g u r e 17-2 shows a l i s t i n g o f t h e FREEZE c a r t r i d g e program. 
The 
e n t r y p o i n t s f o r each o f t h e v a r i o u s methods a r e l a b e l l e d s o t h a t 
y o u may see t h e d i f f e r e n c e s i n t h e 
v a r i o u s 
methods. 
The 
m a i n 
d i f f e r e n c e l i e s i n t h e number o f b y t e s t h a t were pushed o n t o 
t h e 
s t a c k b y t h e N M I , BRK, JSR e t c . t h a t was used t o a c t i v a t e FREEZE. 
A l o o p a t $801F-25 i s used t o 
u l l t h e p r o p e r number o f b y t e s o f f 
t h e s t a c k and s t o r e them a t 
$!FOO. 
T h i s 
p r o c e s s 
r e s t o r e s 
t h e 
s t a c k p o i n t e r back t o i t s o r i g i n a l v a l u e as a 
s i d e 
e f f e c t . 
The 
r e m a i n i n g b y t e s o f t h e $2F00 
a r e a 
a r e 
f i l l e d w i t h 
$ F F ' s 
f o r 
c o n v e n i e n c e i n i n t e r p r e t i n g t h e r e s u l t s o f t h e FREEZE p r o c e s s . 


I n a d d i t i o n 
t o t h e 
m a i n 
r o u t i n e , 
FREEZE 
uses 
t w o 
s p e c i a l 
s u b r o u t i n e s . The s u b r o u t i n e a t $80CO c o p i e s one a r e a o f memory t o 
a n o t h e r . 
It a l w a y s 
c o p i e s 
a 
w h o l e 
number 
o f 
memory 
pages 
( 2 5 6 - b y t e segments). The number o f pages t o copy must 
be 
p l a c e d 
i n t h e a c c u m u l a t o r b e f o r e 
c a l l i n g 
t h e 
r o u t i n e . 
I n a 
s i m i l a r 
f a s h i o n , t h e X - r e g i s t e r i s used t o s p e c i f y t h e a r e a t o copy 
f r o m 
( t h e s o u r c e a r e a ) . O n l y t h e h i g h b y t e o f 
t h e 
b e g i n n i n g 
o f 
t h e 
s o u r c e a r e a i s s p e c i f i e d ; t h e l o b y t e i s assumed t o be 
$00. 
The 
Y - r e g i s t e r i s used t o s p e c i f y t h e h i b y t e o f t h e b e g i n n i n g o f t h e 
a r e a t o copy t o ( t h e d e s t i n a t i o n a r e a ) . 


The copy s u b r o u t i n e s t o r e s t h e b e g i n n i n g a d d r e s s e s o f t h e 
s o u r c e 
and 
d e s t i n a t i o n 
a r e a s 
i n z e r o 
page 
a t 
$FB-FC 
and 
$FD-FE 


r e s p e c t i v e l y . A s i m p l e l o o p i s used 
t o 
l o a d 
a 
b y t e 
f r o m 
t h e 
s o u r c e a r e a and save i t i n t h e d e s t i n a t i o n area. 
The 
pages 
a r e 
c o u n t e d as t h e y a r e c o p i e d and t h e r o u t i n e t e r m i n a t e s 
a f t e r 
t h e 
p r o p e r number o f pages have been done. T h i s r o u t i n e 
i s used 
do 
a l m o s t a l l o f t h e c o p y i n g i n t h e FREEZE 
p r o c e s s , 
s t a r t i n g 
w i t h 
t h e l o w memory a r e a a t $0000-07FF. 
T h i s a r e a o f memory p r e s e n t s a 
problem, s i n c e t h e copy r o u t i n e s t o r e s i t s s o u r c e and d e s t i n a t i o n 
a d d r e s s e s i n t h i s a r e a a t $FB-FE. 
When we u s e t h e r o u t i n e t o copy 
t h e l o w memory a r e a , i t w i l l w i p e o u t t h e v a l u e s 
w h i c h 
were 
i n 


$FB-FE p r e v i o u s l y . T h e r e f o r e , t h e s e v a l u e s a r e saved 
t e m p o r a r i l y 
i n $2F90-2F93 b e f o r e t h e copy r o u t i n e i s c a l l e d . T h i s i s done 
b y 
t h e code a t $8038-41 i n t h e main r o u t i n e . Then t h e 
copy 
r o u t i n e 
i s c a l l e d t o copy t h e l o w memory a r e a up t o $2000-27FF. 
F i n a l l y , 
t h e $FB-FE b y t e s saved e a r l i e r a r e moved i n t o t h e i r c o r r e s p o n d i n g 
p o s i t i o n s i n t h e l o w memory copy, a t $200FB-FE. 
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Next, t h e ROMs and 1 / 0 d e v i c e s a r e s w i t c h e d i n t o memory 
i f t h e y 
w e r e n ' t i n a l r e a d y . Then t h e c o l o r RAM ($D800-DBFF) and V I C 
c h i p 


($D000-FF) 
a r e 
c o p i e d 
down 
t o 
$2800-2BFF 
and 
$2EOO-FF 


r e s p e c t i v e l y . I n o r d e r t o copy t h e 
h i d d e n 
RAM 
areas, 
we 
must 
s w i t c h t h e BASIC and KERNAL ROMs and 1 / 0 d e v i c e s o u t 
o f 
memory. 
T h i s p r e s e n t s a n o t h e r p r o b l e m s i n c e s w i t c h i n g o u t 
BASIC 
o r 
t h e 
KERNAL w i l l a l s o s w i t c h o u t o u r FREEZE c a r t r i d g e ! To 
g e t 
a r o u n d 
t h i s , we download a second s p e c i a l r o u t i n e t o RAM. 
T h i s 
r o u t i n e 
i s l o c a t e d a t $8090-BE i n t h e FREEZE c a r t r i d g e b u t i s downloaded 
t o $2090-BE i n RAM. 
The RAM r o u t i n e i m m e d i a t e l y s w i t c h e s o f f 
t h e 
ROMs and I / O . 
N e x t i t saves t h e c o n t e n t s o f t h e t w o m i s c e l l a n e o u s 
RAM b y t e s a t $0800 and $8000 ( t h e second o f w h i c h was 
u n d e r 
t h e 
FREEZE c a r t r i d g e b e f o r e ) . 


The RAM r o u t i n e t h e n c o p i e s t h e h i d d e n RAM a t 
$A000-BFFF 
( u n d e r 
BASIC) down t o $3000-4FFF and t h e h i d d e n RAM a t $D000-FFFF ( u n d e r 
t h e 1 / 0 d e v i c e s and t h e KERNAL) down t o $5000-7FFF. 
To do t h i s i t 
uses t h e copy s u b r o u t i n e we d i s c u s s e d 
above. 
T h i s 
i s p o s s i b l e 
because t h e copy r o u t i n e was downloaded t o RAM t o o , a t 
$2FCO-DA. 


The c o y r o u t i n e does 
n o t 
r e f e r 
t o 
any 
l o c a t i o n s 
i n memory 
d i r e c t 7 y ( e x c e p t $FB-FE), 
so i t i s c o m p l e t e l y 
relocatable. 
T h a t 
i s , i t can be moved t o an a r e a o f 
memory 
and 
e x e c u t e d 
w i t h o u t 
h a v i n g t o be a l t e r e d t o a d j u s t f o r i t s new l o c a t i o n . 


F i n a l l y , a f t e r a l l c o p y i n g i s done, t h e ROMs 
a r e 
s w i t c h e d 
back 
i n . The s t a c k p o i n t e r and d e c i m a l mode f l a g 
a r e 
i n i t i a l i z e d t o 
t h e i r s t a n d a r d v a l u e s , and a v a l u e i s s e t u p i n 
X 
f o r 
t h e 
V I C 
c h i p . Then FREEZE t e r m i n a t e s b y j u m p i n g i n t o 
t h e 
RESET 
p r o c e s s 
p a s t t h e CBM80 check ( o t h e r w i s e t h e 
FREEZE 
c a r t r i d g e 
w o u l d 
be 
s t a r t e d a l l o v e r a g a i n ! ) . 
T h i s r e t u r n s c o n t r o l o f t h e computer t o 
you, so y o u c a n examine t h e p r e s e r v e d memory. 


You s h o u l d f i n d t h e FREEZE c a r t r i d g e v e r y u s e f u l , e s p e c i a l l y 
f o r 
d o w n l o a d i n g h i d d e n RAM c o n v e n i e n t l y . W i t h i t s a b i l i t y t o p r e s e r v e 
t h e p r o c e s s o r ' s r e g i s t e r s and l o w memory, i t s h o u l d 
be 
a 
handy 
program d e b u g g i ng t o o l t o o . 
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F i g u r e 17-2: FREEZE CARTRIDGE LISTING 


C o l d s t a r t $802E - RESET 
Warm s t a r t $8018 - RESTORE 


8004 C3 C2 CD 38 30 
CBM80 - A u t o s t a r t k e y 


8009 08 
PHP 
JSR E n t r y - Push p r o c . s t a t u s 
800A 7 8 
SEI 
D i s a b l e I R Q i n t e r r u p t s 
800B 8D 03 2F STA $2F03 
N M I RAM V e c t o r E n t r y - Save Acc. 


800E 8E 04 2F STX $2F04 
Save X 
8011 8C 05 2F STY $2F05 
Save Y 
8014 A0 02 
LDY #$02 
3 b y t e s on s t a c k - SR, 
PC l o , PC h i 
8016 D O 03 
BNE $801B 
Always b r a n c h 
8018 78 
SEI 
RESTORE and BRK E n t r y - D i s a b l e I R Q ' s 


8019 A0 05 
LDY #$05 
6 b y t e s on s t a c k - YyXyAySR, PC l o / h i 


801B BA 
TSX 
801C 8E 07 2F STX $2F07 
Save c u r r e n t s t a c k p o i n t e r 
801F 68 
PLA 
P u l l b y t e s f r o m s t a c k ... 
8020 99 00 2F STA $2FOO,Y ... and save 
8023 88 
DEY 
8024 1 0 F9 
BPL $801F 


8026 BA 
TSX 
8027 8E 06 2F STX $2F06 
Save o r i g i n a l s t a c k p o i n t e r 
802A A0 OA 
LDY #BOA 
S t a r t c l e a r i n g a t $2FOA 


802C DO 02 
BNE $8030 
Always b r a n c h 
802E A0 00 
LDY #$OO 
RESET E n t r y - C l e a r a1 1 $2F00 a r e a 
8030 A9 FF 
LDA #$FF 
F i l l e r v a l u e f o r c l e a r 
8032 99 00 2F STA $2FOO,Y 
C l e a r unused a r e a s 
8035 C8 
I N Y 
8036 D O FA 
BNE $8032 
8038 A2 03 
LDX #$03 
Save 4 b y t e s 
803A B5 FB 
LDA $FB,X 
f r o m $FB-FE 


803C 9D 90 2F STA $2F90,X 
t o $2F90-93 


803F C A 
D E X 
8040 DO F8 
BPL $803A 


8042 A9 08 
LDA #$08 
Copy 8 pages ( l o w mem) 


8044 A2 00 
LDX #$00 
f r o m $0000-07FF 
8046 A0 20 
LDY #$20 
t o $2000-27FF 
8048 20 C O 8 0 JSR $80CO 
Copy r o u t i n e 


8048 A2 03 
LDX #$03 


804D BD 90 2F LDA $2F90,X 
Recover o r i g i n a l $FB-FE b y t e s 
8050 9D FB 20 STA $20FB,X 
and s t o r e a t $20FB-FE 


8053 C A 
DEX 
8054 DO F7 
BPL $804D 


8056 A9 37 
LDA #$37 
Make s u r e BASIC 
8058 85 01 
STA $01 
and KERNAL ROMs 


805A A9 2F 
LDA #$2F 
and 1/0 d e v i c e s 
805C 85 00 
STA $00 
a r e s w i t c h e d i n 
805E A9 06 
LDA #$06 
Copy 6 pages ( c o l o r RAM) 
8060 A2 D8 
LDX #$D8 
f r o m $D800-DBFF 


8062 A0 28 
LDY #$28 
t o $2800-2BFF 
8064 20 C O 80 JSR $80CO 
COPY 
8067 A9 01 
LDA #$01 
Copy 1 page ( V I C ) 


8069 A2 DO 
LDX #$DO 
f r o m $D000-FF 


806B A0 2E 
LDY #$2E 
t o $2E00-FF 
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806D 20 C O 8 0 JSR $8OCO 
COPY 
8070 A0 4F 
LDY #$4F 
Hidden RAM r o u t i n e 
8072 B9 90 80 LDA $8090,Y 
Download f r o m $8090-DF 
8075 99 90 2F STA $2F90,Y 
t o $2F90-DF 


8078 88 
DEY 
8079 10 F7 
BPL $8072 
807B 4C 90 2F JMP $2F90 
E x e c u t e h i d d e n RAM r o u t i n e 


Downloads t h e h i d d e n RAM u n d e r BASIC, 
1/0 d e v i c e s and KERNAL t o $3000-7FFF 


8090 A9 34 
LDA #$34 


8092 85 01 
STA $01 
8094 AD 00 08 LDA $0800 
8097 8D 08 2F STA $2F08 
809A AD 00 80 LDA $8000 
809D 8D 09 2F STA $2F09 
80A0 A9 20 
LDA #$20 


80A2 A2 A0 
LDX #$A0 


80A4 A0 30 
LDY #$30 


80A6 20 C O 2F JSR $2FCO 
80A9 A9 30 
LDA #$30 


80AB A2 DO 
LDX #$DO 
80AD A0 50 
LDY #$50 


80AF 20 C O 2F JSR $2FCO 
80B2 A9 37 
LDA #$37 


80B4 85 01 
STA $01 


80B6 A2 FF 
LDX #$FF 


80B8 9A 
TXS 


80B9 D8 
CLD 
80BA A2 00 
LDX #$00 


80BC 4C EF FC JMP $FCEF 


T u r n o f f ROMs and 1 / 0 
d e v i c e s ( a 1 1 RAM) 
B y t e p r e c e d i n g BASIC a r e a 
- save 
B y t e u n d e r c a r t r i d g e a r e a 
- save 
Copy 32 pages ( u n d e r BASIC) 
f r o m $A000-BFFF 


t o $3000-4FFF 
COPY 
Copy 48 pages ( u n d e r I / O , 
KERNAL) 
f r o m $D000-FFFF 


t o $5000-7FFF 
COPY 
Turn ROMS and 1 / 0 
d e v i c e s back on 
S e t s t a c k p o i n t e r 
t o t o p o f s t a c k 
C l e a r d e c i m a l mode 
P r e p a r e v a l u e f o r V I C 
Jump i n t o RESET p a s t CBM80 check 


Copy r o u t i n e - c o p i e s w h o l e no. o f 
pages f r o m one a r e a t o a n o t h e r . 


80CO 86 FC 
STX $FC 


80C2 8 4 FE 
STY $FE 


80C4 AA 
TAX 


80C5 A9 00 
LDA #$00 


80C7 85 FB 
STA $FB 


80C9 85 FD 
STA $FD 


80CB A8 
TAY 
80CC B1 FB 
LDA ($FB),Y 


80CE 91 FD 
STA ($FD),Y 


80D0 C8 
I N Y 


80D1 DO F9 
BNE $80CC 


80D3 E6 FC 
I N C $FC 


80D5 E6 FE 
I N C $FE 


80D7 CA 
DEX 


80D8 DO F2 
BNE $8OCC 


80DA 60 
RTS 


H i b y t e - s o u r c e a r e a 


I 1 
" - d e s t i n a t i o n a r e a 
No. pages t o copy 


Lo b y t e - s o u r c e a r e a 


I 1 
" - d e s t i n a t i o n a r e a 
Z e r o i n d e x 
Load b y t e 
Save 


N e x t s o u r c e page 
N e x t d e s t i n a t i o n page 


End o f FREEZE c a r t r i d g e l i s t i n g 
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ORACLE/PAPERCLIP CARTRIDGE 


I f you use DELPHI'S O R A C L E ( t m ) database o r PAPERCLIP 
( t m ) 
word 
processor from 
B a t t e r i e s 
Included, 
you 
know 
t h a t 
t h e s e 
two 
programs a r e among t h e b e s t of 
t h e i r 
type. 
Both 
programs 
a r e 
loaded with f e a t u r e s , b u t you pay 
a 
high 
p r i c e 
f o r 
a l l 
t h a t 
s o p h i s t i c a t i o n . 
We're 
not 
t a l k i n g 
about 
t h e 
purchase 
p r i c e 
( t h e y ' r e worth every c e n t ) b u t r a t h e r t h e length of time i t t a k e s 
t o load t h e 
program 
i n 
from 
d i s k . 
Unlike 
most 
commercially 
protected programs, t h e long load time i s n ' t because of any fancy 
p r o t e c t i o n on t h e d i s k . In f a c t , t h e disk i s t o t a l l y unprotected. 
The long load i s simply due 
t o t h e 
length 
of 
t h e 
program - 


t h e r e ' s a l o t of code t h e r e . 


The p r o t e c t i o n scheme used on t h e s e products employs 
a 
hardware 
key o r "dongle" which plugs i n t o j o y s t i c k p o r t # l . 
Without 
t h i s 
key, t h e programs w i l l not r u n . This i s a good compromise between 
convenience f o r t h e user and p r o t e c t i o n f o r t h e manufacturer. The 
user may make a s many backup copies of t h e 
o r i g i n a l 
program 
as 
desired - b u t with only one key t h e programs can only be executed 
on one computer a t a time. This f e a t u r e l e t s 
t h e 
user 
p u t 
t h e 
program anywhere they wish, such as on t h e i r d a t a disk o r a 
hard 
disk - o r a CARTRIDGE! 


T h a t ' s r i g h t , you can p u t B O T H Oracle ( t m ) and Paperclip ( t m ) 
on 
t h e same c a r t r i d g e ( l e t ' s c a l l them O R and PC from now on - 
note 
t h a t t h e Oracle has been renamed The C o n s u l t a n t ) . With a push 
of 
t h e RESET button ( o r on powerup) you can have a menu 
appear 
and 
o f f e r you a choice of programs. Simply choose t h e one 
you 
want, 
and seconds l a t e r t h e program i s u p and running (assuming t h e key 
i s plugged i n ) . Not only i s t h i s t h e u l t i m a t e i n convenience, b u t 
i t can be p r a c t i c a l too. Time i s money, as they 
say, 
e s p e c i a l l y 
i f you use t h e s e programs f o r business ( l i k e we d o ) . 
I f 
you 
go 
back and f o r t h from PC t o BASIC, a c a r t r i d g e can save you 
a 
LOT 
of time. 


For t h e O R / P C c a r t r i d g e , y o u ' l l need a PC4 bank-switch 
c a r t r i d g e 
board. You'll a l s o need f o u r 27128 (16K) EPROMS. We 
a l s o 
highly 
recommend t h a t you g e t a p l a s t i c housing f o r t h e c a r t r i d g e . These 
m a t e r i a l s 
a r e 
a l l 
a v a i l a b l e 
from 
CSM. 
The 
program 
disk 
accompanying 
t h i s 
book 
c o n t a i n s 
t h e 
menu 
program 
f o r 
t h i s 
c a r t r i d g e . I t does N O T c o n t a i n t h e O R o r PC program f i l e s - t h e s e 
must be purchased from B a t t e r i e s Included. 


To s t a r t o f f , load i n PROMOS and r u n i t . PROMOS w i l l 
p u t 
i t s e l f 
u p a t t h e top of BASIC memory 
i n 
t h e 
$ 9 0 0 0 ' ~ . Don't 
use 
t h e 


tlESMON/PROMOS c a r t r i d g e because i t s t a r t s i n memory a t $8000, and 
w e ' l l need t h a t a r e a . Now load i n MICROMON a t $COO0 
and 
execute 
i t . The f i r s t t h i n g you should do i s c l e a r out t h e 
memory 
w e ' l l 
use: 
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Now i n s e r t t h e p r o g r a m d i s k and l o a d t h e menu program: 


L " O R / P C 
MENU" 


T h i s p r o g r a m w i l l l o a d i n a t $1000. We have 
t o 
s t a r t 
t h i s 
f a r 
down i n memory s i n c e t h e O R and PC f i l e s a r e s o l o n g . Now 
i n s e r t 
y o u r OR p r o g r a m d i s k i n t h e d r i v e . Load t h e m a i n OR p r o g r a m 
i n t o 
memory w i t h : 


L 1400 "ORACLE*" 


T h i s l o a d s i n t h e f i l e s t a r t i n g a t $1400, p a s t 
t h e 
end 
of 
t h e 
menu program. Depending on w h i c h v e r s i o n o f t h e 
OR 
p r o g r a m 
y o u 
have, t h e e n d i n g a d d r e s s r e p o r t e d b y M I C R O M O N w i l l be 
d i f f e r e n t . 


We'l'l j u s t b u r n t h e w h o l e $1000-8FFF a r e a t o EPROM 
so 
we 
w o n ' t 
have t o w o r r y a b o u t what t h e e n d i n g a d d r e s s i s ( a s l o n g as t h e OR 
p r o g r a m ends b e f o r e $ 9 0 0 0 ! ) . It w i l l t a k e 
t w o 
27128 
EPROMs 
t o 
h o l d t h i s much memory, and s o w e ' l l have 
t o b u r n 
them 
i n t w o 
s e p a r a t e s t e p s . 


B e f o r e i n s e r t i n g t h e 
f i r s t 
EPROM, 
y o u 
s h o u l d 
i n i t i a l i z e 
t h e 
PROMENADE. Type Z and h i t RETURN. Now i n s e r t t h e f i r s t 27128 i n t o 
t h e PROMENADE ( n o t c h t o t h e l e f t as a l w a y s ) . F l i p t h e l e v e r 
down 
t o l o c k i t i n p l a c e . B u r n t h e f i r s t h a l f o f t h e memory a r e a (16K) 
t o t h e EPROM w i t h t h e f o l l o w i n g command: 


D o n ' t u s e t h e l e t t e r s P I ; u s e t h e p i k e y on t h e k e y b o a r d ( s h i f t e d 
up-arrow, 
n e x t t o RESTORE). 
PROMOS 
r e q u i r e s 
i t s a d d r e s s e s 
i n 
d e c i m a l : 4096 = $1000 and 20479 = $4FFF. 


B u r n i n g t h i s much memory t o EPROM c a n t a k e q u i t e a 
f e w 
m i n u t e s , 
so be p a t i e n t . U s i n g a PMW 
( t h e l a s t number i n t h e command) o f 10 
o r 1 4 
i n s t e a d 
o f 
6 
w i l l 
speed 
i t up 
b u t 
may 
a f f e c t 
t h e 
r e l i a b l i l i t y . I f y o u r EPROMs have a LARGE MATRIX 
ONLY, 
y o u 
can 
t r y a n o t h e r s h o r t c u t t h a t m i g h t save a l o t o f t i m e . The m a t r i x i s 
t h e h e a r t of t h e c h i p , v i s i b l e t h r o u g h t h e window on t o p . A l a r g e 
m a t r i x w i l l be approx. 3 / 8 " x 1 / 4 " ; 
a s m a l l m a t r i x w i l l 
be 
h a l f 
t h a t s i z e o r s m a l l e r . The command f o r a l a r g e m a t r i x c h i p i s : 


D o n ' t u s e t h i s command on a s m a l l m a t r i x c h i p ! I t w i l l 
p r o b a b l y 
damage t h e EPROM! I f y o u a r e n ' t s u r e w h i c h c h i p y o u have, u s e t h e 
f i r s t v e r s i o n o f t h e command. It w i l l w o r k w i t h e i t h e r t y p e . 
The 
s h o r t c u t command w o r k s b y u s i n g a h i g h e r programming v o l t a g e t h a n 
u s u a l ( 2 5 v o l t s vs. 21 v o l t s ) . The l a r g e r m a t r i x c h i p s 
c a n 
t a k e 
t h e e x t r a v o l t a g e , b u t t h e s m a l l e r one c a n ' t . T h i s 
method 
works 
q u i t e w e l l f o r u s b u t we c a n ' t g u a r a n t e e t h a t i t w i l l 
work 
f o r 
y o u . 
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By t h e way, i f y o u have EPROMs l a b e l l e d 27128A, 
t h e y 
s h o u l d 
be 
programmed a t o n l y 12.5 v o l t s . They may o r may n o t 
say 
t h i s 
on 
them. You w i l l damage them i f y o u d o n ' t u s e 
t h e 
r i g h t 
CW 
( t h e 
n e x t t o l a s t number i n t h e command). 
The 
p r o p e r 
CW 
f o r 
t h e s e 
c h i p s i s 6, so t h e y e n t i r e command s h o u l d be: 


When t h e c h i p i s f i n i s h e d , t a k e i t o u t o f t h e PROMENADE and l a b e l 
i t c h i p #O (we s t a r t n u m b e r i n g them a t 0 because t h a t ' s 
t h e 
way 
t h e c a r t r i d g e b o a r d i s l a b e l e d ) . Now i n s e r t t h e 
n e x t 
EPROM 
and 
b u r n t h e second 16K o f memory w i t h : 


P I 20480, 36863, 0, 
5, 
6 
( A n y s i z e m a t r i x ) 
o r P I 20480, 36863, 0, 4, 
7 
(LARGE MATRIX ONLY!) 


(20480 = $5000 and 36863 = $8FFF) 


Remove t h i s c h i p f r o m t h e PROMENADE and l a b e l i t c h i p # l . 


Now i t ' s t i m e t o do t h e PC program. S t a r t b y c l e a r i n g t h e 
memory 
a r e a a g a i n : 


I n s e r t y o u r PC d i s k and l o a d i n t h e PC program: 


L 1000 "PAPERCLIP*" 


Once a g a i n t h e e n d i n g a d d r e s s 
w i l l 
v a r y 
f r o m 
one 
v e r s i o n 
t o 
a n o t h e r , so w e ' l l 
j u s t 
b u r n 
t h e 
w h o l e 
$1000-8FFF 
area. 
The 
commands t o b u r n t h e o t h e r t w o EPROMS a r e 
e x a c t l y 
t h e 
same 
as 
b e f o r e . Always s t a r t b y 
i n i t i a l i z i n g 
t h e 
PROMENADE 
w i t h 
a 
Z 
command. F o r EPROM #2, use: 


P I 4096, 20479, 0, 5, 6 
( A n y s i z e m a t r i x ) 
P I 4096, 20479, 0, 4, 
7 
(LARGE MATRIX ONLY!) 


F o r EPROM #3, 
use: 


P I 20480, 36863, 0, 5, 6 
(Any s i z e m a t r i x ) 
o r P I 20480, 36863, 0, 4, 
7 
(LARGE MATRIX 
O N L Y ! ) 


Be s u r e t o l a b e l t h e 
EPROMs 
a f t e r 
y o u 
remove 
them 
f r o m 
t h e 
PROMENADE t o a v o i d m i x i n g them up. 


Now y o u ' r e r e a d y t o p l u g t h e EPROMs i n t o t h e 
b a n k - s w i t c h 
b o a r d . 
The f o u r s o c k e t s on t h e b o a r d a r e l a b e l e d f r o m 0 t o 3, 
and 
a l l 
y o u have t o do i s make s u r e 
each 
EPROM 
i s i n s e r t e d 
i n t o 
t h e 
c o r r e s p o n d i n g s o c k e t (EPROM #O i n s o c k e t # O and so o n ) . S o c k e t #O 
i s t h e c l o s e s t one t o t h e c o m p u t e r when t h e c a r t r i d g e i s p l u g g e d 
i n , j u s t i n case y o u ' r e n o t s u r e . The o t h e r s a r e 
i n o r d e r 
f r o m 
#O. The n o t c h on each EPROM 
s h o u l d 
be 
t o 
t h e 
LEFT 
when 
t h e 
c a r t r i d g e i s i n s e r t e d i n t h e computer. T h e r e i s u s u a l l y 
a 
n o t c h 
o r d o t on t h e s o c k e t t o g u i d e you. 
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Now p u t t h e b o a r d i n t o t h e b o t t o m h a l f 
o f 
t h e 
p l a s t i c 
h o u s i n g 
( t h e h a l f w i t h t h e p l a s t i c p i n s ) . Make 
t h e 
s u r e 
t h e 
b o a r d 
i s 
f l i p p e d so t h e EPROMs a r e on t h e UPPER s i d e ( s t i l l v i s i b l e ) . 
Now 
p u t t h e t o p h a l f o f t h e c a s e on. The c a r t r i d g e i s r e a d y f o r use! 


L e t ' s t a k e i t o u t f o r a s p i n . T u r n o f f t h e computer ( o r c a r t r i d g e 
s l o t i f y o u have an e x p a n s i o n b o a r d ) . I n s e r t 
t h e 
c a r t r i d g e 
and 
t u r n t h e computer power o r c a r t r i d g e s l o t back on. You s h o u l d 
b e 
p r e s e n t e d w i t h a menu showing t h r e e o p t i o n s : 


0 - E x i t t o BASIC 
1 - D e l p h i ' s O r a c l e 
2 - P a p e r c l i p 


A t t h i s p o i n t t h e menu 
p r o g r a m 
has 
been 
downloaded 
i n t o 
t h e 
normal BASIC a r e a as a 
r e g u l a r 
BASIC 
program. 
I f y o u 
choose 
o p t i o n 0, t h e c o m p u t e r w i l l 
be 
RESET 
and 
t h e 
normal 
powerup 


s c r e e n w i l l appear. To r e a c t i v a t e t h e c a r t r i d g e , y o u MUST 
u s e 
a 
h a r d RESET (powerup o r 
RESET 
b u t t o n ) . 
A 
s o f t w a r e 
RESET 
(SYS 


64738) w i l l NOT work. 


I f y o u choose e i t h e r o f t h e o t h e r o p t i o n s , make s u r e y o u h a v e t h e 
p r o p e r k e y f o r t h a t p r o g r a m p l u g g e d i n t o t h e j o y s t i c k p o r t b e f o r e 
you h i t RETURN! I t w i l l t a k e o n l y a moment f o r t h e p r o g r a m t o 
be 
downloaded f r o m t h e c a r t r i d g e . PC t a k e s a b o u t 13 
seconds 
b e f o r e 
i t comes up because i t i s h e a v i l y e n c r y p t e d . A f t e r t h e p r o g r a m i s 
downloaded, t h e c a r t r i d g e w i l l a u t o m a t i c a l l y s w i t c h i t s e l f o f f so 
t h a t a l l o f t h e n o r m a l RAM i s a v a i l a b l e f o r t h e program. 
It c a n 
do t h i s because o f t h e 
s p e c i a l 
b a n k - s w i t c h i n g 
c i r c u i t r y 
b u i l t 
i n t o i t . I f y o u h a v e a c a r t r i d g e power s w i t c h o r e x p a n s i o n board, 
y o u can s w i t c h t h e c a r t r i d g e power o f f a f t e r t h e 
p r o g r a m 
i s up 
and r u n n i n g . T h i s w i l l g i v e y o u r power s u p p l y 
box 
a 
b i t 
o f 
a 
b r e a k . 


T h i s menu p r o g r a m c a n a l s o b e u s e d t o p u t 
o t h e r 
l a r g e 
programs 
o n t o 
a 
b a n k - s w i t c h 
b o a r d . 
U n l e s s 
y o u 
want 
t o 
r e w r i t e 
t h e 


d o w n l o a d / r u n r o u t i n e ( n o t an e a s y t a s k ) , y o u c a n 
o n l y 
have 
two 
programs and t h e y must occupy t h e same a r e a s i n t h e c a r t r i d g e 
as 
OR and PC. They w i l l b e downloaded t o t h e BASIC a r e a and RUN l i k e 
BASIC 
programs. 
J u s t 
f o l l o w 
t h e 
d i r e c t i o n s 
above 
f o r 
t h i s 
c a r t r i d g e , and 
l o a d y o u r 
programs 
a t 
t h e 
a p p r o p r i a t e 
t i m e s 
i n s t e a d . Changing t h e t i t l e s on t h e menu i s r e l a t i v e l y s i m p l e i f 
y o u examine t h e menu p r o g r a m w i t h a m o n i t o r . 
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E P R O M H A N D B O O K 


( I N T E N T I O N A L L Y L E F T B L A N K ) 


B L A N K 
P A G E 128 


GLOSSARY OF TERMS 


ACTIVE LOW - Refers t o a c o n t r o l l i n e t h a t i s n o r m a l l y 
high 
( + 5 


v o l t s ) , b u t which g o e s low ( g r o u n d e d , 0 
v o l t s ) 
t o p e r f o r m 
i t s 
a s s i g n e d f u n c t i o n . Most EPROM e n a b l e lines a r e a c t i v e 
low, 
t h a t 
i s , t h e y e n a b l e the EPROM w h e n t h e y a r e b r o u g h t low 
and 
d i s a b l e 
i t w h e n l e f t h i g h . 


ADDRESS DECODING - The p r o c e s s o f b r e a k i n g down a memory 
a d d r e s s 
i n o r d e r t o s e l e c t t h e c o r r e c t c h i p where the d a t a r e s i d e s . 
T h i s 
i s how c h i p s a r e a s s i g n e d t h e i r l o c a t i o n s i n memory. 


ADDRESS LINES - The l i n e s o v e r which 
a d d r e s s e s 
a r e sent 
t o a 
c h i p . The c h i p s e l e c t s a b y t e o f d a t a from w i t h i n i t s e l f based on 
t h e a d d r e s s s e n t . 


AUTOSTART CARTRIDGE - A c a r t r i d e t h a t s t a r t s a u t o m a t i c a l l y 
when 
t h e computer i s t u r n e d on o r a fl ESET 
i s done. 
Most 
commercial 
c a r t r i d g e s a u t o s t a r t t h e m s e l v e s . 


BANK-SWITCHING - A t e c h n i q u e used i n some c a r t r i d g e s t h a t 
a l l o w s 
them t o s w i t c h "banks" o f memory (memory c h i p s ) i n and o u t o f t h e 
c o m p u t e r ' s memory s p a c e . T h i s a l l o w s a b a n k - s w i t c h 
c a r t r i d g e 
t o 
have a c c e s s t o more memory t h a n a 
s t a n d a r d 
c a r t r i d g e , 
a l t h o u g h 
not a l l a t the same time. C a r t r i d g e s a r e l i m i t e d t o 16K of memory 
a t a t i m e on t h e C64 ( 3 2 ~ 
on the C128). 
Bank-switching 
i s 
a l s o 
used by t h e C64 and C128 t h e m s e l v e s t o s w i t c h 
s y s t e m 
ROMS, 
1 / 0 
d e v i c e s , c a r t r i d g e s , e t c . i n and o u t o f memory. 


BINARY - A number s y s t e m t h a t c o r r e s p o n d s v e r y c l o s e l y t o the way 
computers a c t u a l l y s t o r e i n f o r m a t i o n . B i n a r y numbers use o n l y the 
d i g i t s 0 and 1. B i n a r y i s a l s o c a l l e d b a s e 2. 


BIT - The s m a l l e s t u n i t o f i n f o r m a t i o n t h a t a computer 
can 
d e a l 
w i t h . " B i t " s t a n d s f o r B i n a r y d i g I T - s o m e t h i n g 
t h a t i s 
always 
e i t h e r a 0 o r a 1 (OFF o r O N ) . 


BURNING AN EPROM - Another 
t e r m 
f o r 
programming 
an 
EPROM 
- 
s t o r i n g i n f o r m a t i o n on i t . 


BYTE - The n e x t l e v e l o f memory o r g a n i z a t i o n above the b i t l e v e l . 
One b y t e c o n s i s t s o f 8 b i t s t h a t a r e always s t o r e d 
o r 
r e t r i e v e d 
t o g e t h e r . 


CARTRIDGE - R e f e r s t o the c o m b i n a t i o n o f a 
c a r t r i d g e 
board 
and 
t h e memory c h i p s t h a t r e s i d e on i t . A c a r t r i d g e i s e s s e n t i a l l y a 
p l u g - i n memory e x p a n s i o n u n i t c o n t a i n i n g a program s t o r e d on some 
t y p e of ROM ( r e a d - o n l y memory). 


CW - A PROMOS C o n t r o l Word. The CW i s used t o t e l l 
PROMOS 
what 
t y p e of c h i p i s b e i n g r e a d o r w r i t t e n , s o t h a t 
PROMOS 
can 
t e l l 
the PROMENADE the c o r r e c t v o l t a g e s , c o n t r o l s i g n a l s , 
p i n s , 
e t c . 
t o u s e . Using t h e wrong CW can p e r m a n e n t l y damage a c h i p . 
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DATA LINES - The l i n e s o v e r which d a t a i s sent 
t o o r 
r e c e i v e d 
from a c h i p . T h e r e a r e u s u a l l y 8 d a t a l i n e s , c o r r e s p o n d i n g t o t h e 
8 b i t s i n a b y t e . Sometimes t h e same p h y s i c a l l i n e s a r e used 
f o r 
b o t h d a t a and a d d r e s s e s , a t e c h n i q u e 
c a l l e d 
m u l t i p l e x i n g . 
T h i s 
r e q u i r e s p r e c i s e t i m i n g . 


DECIMAL - O u r o r d i n a r y e v e r y d a y number s y s t e m , a l s o c a l l e d 
b a s e 
10. Numbers a r e made up o f d i g i t s s e l e c t e d from the r a n g e 0 t o 9. 
A p a r t i c u l a r d i g i t v a r i e s i n v a l u e a c c o r d i n g t o i t s p l a c e i n the 
number. 


DIP - S t a n d s f o r Dual I n - l i n e Package. 
I t r e f e r s 
t o the 
most 
common way o f a r r a n g i n g t h e p i n s on a 
c h i p - 
i n 
two 
s t r a i g h t 
rows. A l l EPROMs i n t h i s book a r e DIP c h i p s ( a n d 
no, 
you 
c a n ' t 
s e r v e t h e s e DIP c h i p s a t a p a r t y ) . 


EEPROM - S t a n d s f o r E l e c t r i c a l l y E r a s a b l e , Programmable Read-Only 
Memory. B a s i c a l l y , a memory c h i p t h a t d o e s n ' t l o s e i t s d a t a 
w h e n 
the power i s removed, b u t which can be e r a s e d u s i n g an e l e c t r i c a l 
s i g n a l r a t h e r t h a n u l t r a v i o l e t l i g h t ( d i s t i n g u i s h i n g i t from 
an 
E P R O M ) . 


ENABLE LINE - A l i n e which c o n t r o l s a c h i p , t u r n i n g i t on o r 
o f f 
a s needed. The e n a b l e 
l i n e i s used 
by 
the 
a d d r e s s 
d e c o d i n g 
c i r c u i t r y t o t u r n on a c h i p when a c e r t a i n r a n g e o f a d d r e s s e s 
i s 
r e f e r e n c e d . T h i s i s how a c h i p i s a s s i g n e d a l o c a t i o n i n 
memory. 
Other t y p e s o f c h i p s b e s i d e s memory c h i p s a l s o have e n a b l e l i n e s . 


EPROM - S t a n d s 
f o r E r a s a b l e 
Programmable 
Read-Only 
Uemory. 
B a s i c a l l y , a memory c h i p t h a t d o e s n ' t 
l o s e i t s d a t a 
w h e n 
the 
power i s removed, b u t which can be e r a s e d w i t h u l t r a v i o l e t 
l i g h t 
and r e u s e d . 


EXPANSION BOARD - A d e v i c e t h a t p l u g s i n t o the c a r t r i d g e p o r t and 
h a s one o r more " s l o t s " on i t t h a t 
c a r t r i d g e s 
can 
be 
plugged 
i n t o . The e x p a n s i o n b o a r d w i l l a l l o w c a r t r i d g e s t o be s w i t c h e d on 
and o f f i n d e p e n d e n t l y o f t h e computer. 


EXROM - P i n 9 o f the c a r t r i d g e p o r t . I f a c a r t r i d g e grounds 
just 
E X R O M , 
the 
P L A 
w i l l 
s e l e c t 
t h e 
8K 
s t a n d a r d 
c a r t r i d g e 
c o n f i g u r a t i o n . 
I f 
o t h e r 
c o n t r o l 
l i n e s 
s u c h 
a s 
GAME 
a r e 
m a n i p u l a t e d , one o f the o t h e r c a r t r i d g e memory c o n f i g u r a t i o n s may 
be s e l e c t e d . A good e x p a n s i o n board w i l l a l l o w you t o s w i t c h GAME 
and E X R O M s e p a r a t e l y . 


6AME - P i n 8 o f the c a r t r i d g e p o r t . I f a c a r t r i d g e 
grounds 
just 
G A M E , t h e P L A w i l l s e l e c t t h e ULTIMAX memory c o n f i g u r a t i o n . O t h e r 
memory c o n f i g u r a t i o n s 
can 
be 
s e l e c t e d 
by 
m a n i p u l a t i n g 
o t h e r 
c o n t r o l l i n e s s u c h a s E X R O M . 


HEXADECIMAL - A u s e f u l way o f 
e x p r e s s i n g 
numbers 
when 
d e a l i n g 
w i t h c o m p u t e r s , a l s o c a l l e d b a s e 
16. 
Numbers 
a r e made 
up 
of 
d i g i t s s e l e c t e d from t h e r a n g e 0 t o 9 and A 
t o 
F 
(A=10, 
B = l l , 


e t c . ) . Hexadecimal c a n be v e r y e a s i l y c o n v e r t e d t o b i n a r y 
( b a s e 


2 1 , and v i c e v e r s a . 
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HIRAM - A 
control 
1 i n e 
a c c e s s i b l e 
through 
b i t 
1 of 
memory 
location 
$0001 
(which 
a c t u a l l y 
r e s i d e s 
i n 
t h e 
651 0 
microprocessor). Generally, t h i s l i n e switches t h e K E R N A L , 
BASIC 
and c a r t r i d g e ROMs i n o r out of memory t o g e t h e r . I t s e f f e c t 
a l s o 
depend on o t h e r l i n e s such a s L O R A M . 


LORAM - A 
control 
l i n e 
a c c e s s i b l e 
through 
b i t 
0 
of 
memory 
location 
$0001 
(which 
a c t u a l l y 
r e s i d e s 
i n 
t h e 
651 0 
microprocessor). Generally, t h i s 
l i n e 
switches 
t h e 
BASIC 
and 
c a r t r i d g e ROMs i n o r o u t of memory t o g e t h e r . I t s e f f e c t s 
depend 
on other l i n e s such a s HIRAM. 


UACHINE LANGUAGE - Also c a l l e d M L , t h i s i s t h e microprocessor's 
" n a t i v e language". ML i n s t u c t i o n s a r e s t o r e d i n a form s i m i l a r t o 
binary, b u t a r e u s u a l l y converted t o hexadecimal f o r convenience. 
A n even more convenient form i s c a l l e d assembly 
language, 
which 
uses names and symbols r a t h e r than numbers. ML 
i n s t r u c t i o n s 
a r e 
l e s s powerful b u t much f a s t e r than "high 
l e v e l " 
languages 
l i k e 
BASIC. High l e v e l languages m u s t be converted t o ML 
before 
they 
can be executed. 


MATRIX - The r e c t a n g u l a r piece of s i l i c o n t h a t a c t u a l l y holds t h e 
information i n a memory chip. On EPROMS, i t i s v i s i b l e 
through 
t h e q u a r t z window on top. 


PLA - A s p e c i a l Programmed Logic Array c h i p used on 
t h e 
C64 
t o 
manage memory. This c h i p i s r e s p o n s i b l e f o r switching c a r t r i d g e s , 
system ROMS, 
RAM, 1/0 d e v i c e s , e t c . i n and o u t of memory. 


PUW - A PROMOS Program Method Word. The PMW t e l l s t h e 
PROMENADE 
which algorithm (procedure) t o use when i t programs a chip. While 
t h e r e i s no " r i g h t " PMW f o r a c h i p , d i f f e r e n t PMW's w i l l be 
vary 
in r e l i a b i l i t y . 


PROM - A 
Programmable 
Read-Only 
Memory 
chip. 
PROMS 
can 
be 
programmed ( w r i t t e n ) by t h e u s e r , b u t only once. They 
cannot 
be 
erased. 


PROMENADE - The b e s t EPROM programmer a v a i l a b l e f o r t h e C64, 
and 
probably t h e b e s t f o r any microcomputer. Also works on t h e 
VIC20 


and C128. 


PROMOS - A s p e c i a l program provided w i t h 
t h e 
P R O M E N A D E . 
PROMOS 
adds several commands t o t h e computer t h a t can be 
used 
t o read 
and w r i t e memory c h i p s such as EPROMs. 


PROGRAMMING AN EPROM - The process of s t o r i n g information onto an 
EPROM, using a s p e c i a l device c a l l e d an E P R O M programmer (such as 
t h e P R O M E N A D E ) . 


RAM - Random Access Memory, o r memory i n which any 
byte 
can 
be 
i n d i v i d u a l l y read o r w r i t t e n t o a t any time. 
Usually 
considered 
t h e opposite of ROM. 
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RESET (HARD) - A RESET 
i n i t i a t e d 
t h r o u g h 
hardware, 
e i t h e r 
on 
power-up ( b y a s p e c i a l 
c i r c u i t 
i n t h e 
C64) 
o r 
by 
t h e 
u s e r 
( t h r o u g h a RESET s w i t c h ) . A u t o m a t i c a l l y s w i t c h e s t h e system 
ROMs 
i n t o memory and c l e a r s most 1 / 0 d e v i c e s . 
. 


RESET (SOFT) - A RESET i n i t i a t e d t h r o u g h s o f t w a r e , u s u a l l y w i t h a 
S Y S 64738 
(BASIC) 
o r 
G FCE2 
( m o n i t o r ) 
command. 
Does 
n o t 
n e c e s s a r i l y c l e a r 1 / 0 d e v i c e s o r s w i t c h t h e system ROMs i n . 


ROM - Read-Only Memory. S t r i c t l y s p e a k i n g , a memory c h i p w h i c h i s 
w r i t t e n w i t h d a t a when i t ' s m a n u f a c t u r e d and w h i c h can 
n e v e r 
be 
a l t e r e d l a t e r . A l s o used l o o s e l y t o r e f e r t o any non-RAM 
d e v i c e , 
such as PROMS, EPROMs, e t c . 


ROMH - A c o n t r o l l i n e o f t h e c a r t r i d g e p o r t ( p i n B ) t h a t i s used 
by t h e PLA t o e n a b l e t h e second ROM (ROM h i g h ) 
i n a 
c a r t r i d g e . 
When t h e PLA b r i n g s t h i s l i n e 
l o w 
( g r o u n d s 
i t ) , 
t h e 
c h i p 
i s 


e n s b l e d and w i l l r e s p o n d t o a memory r e q u e s t . 


ROML - A c o n t r o l l i n e o f t h e c a r t r i d g e p o r t ( p i n 11) t h a t i s used 
by t h e PLA t o e n a b l e t h e f i r s t ROM (ROM l o w ) i n a c a r t r i d g e . When 
t h e PLA b r i n g s t h i s l i n e l o w ( g r o u n d s i t ) , t h e 
c h i p 
i s e n a b l e d 
and w i l l r e s p o n d t o a memory r e q u e s t . 


ULTIHAX - A game machine t h a t was d i s c o n t i n u e d by Commodore. 
The 
C64 has a s p e c i a l memory c o n f i g u r a t i o n 
t h a t 
a l l o w s 
i t t o 
r u n 
ULTIMAX c a r t r i d g e s . 


UV LIGHT - U l t r a v i o l e t l i g h t . A p a r t i c u l a r w a v e l e n g t h o f UV l i g h t 
(2537 Angstroms) i s used t o e r a s e EPROMs. T h i s l i g h t i s hazardous 
t o t h e s k i n and eyes. 
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DATA SHEETS 


The f o l l o w i n g i n f o r m a t i o n i s p r o v i d e d c o u r t e s y o f t h e v a r i o u s 
m a n u f a c t u r e r s . We w o u l d l i k e t o t h a n k them f o r t h i s i n f o r m a t i o n 
and f o r t h e i r a s s i s t a n c e t h r o u g h o u t t h e book. 


GENERAL TECHNICAL INFORMATION 


ERASING THE A M 6 4 
In order to clear all locations of their programmed contents, it is 
necessary to expose the Am2764 to an ultraviolet light source. A 
dosage of 15 Wseconddcm2 is required to completely erase an 
Arn2764. This dosage can be obtained by ex 
ure to an ul- 
traviolet lamp [(wavelength of 2 9 7 Angstroms (Gwith intensity 
of 12000p~/crn2 for 15 to 20 minutes. The Am2764 should be 
.bout one inch from the source and all fllters should be removed 
from thr UV light source prior to erasure. 
It 4s important to note that the Am2764, and similar devces. m# 
erase with light sources having wavelengths shorter than 4000 
Angstroms. Although erasure times w~ll be much longer than with 
UV sources at 2537k nevertheless the exposure 6 fluorescent 
hht and sunllaht will eventually erase theAm2764. and exwsure 
tithem should be prevented reallze maximum system reliabil- 
ity. If used in such an environment. the package window should 
be covered by an opaque label or substance. 
PROGRAMMING THE Am2764 


Upon delivery, or after each erasure the Am2764 has all 65538 
bib in the "1': or hlgh state. "0s are baded Into the Am2764 
through the procedure of programming. 
The programming mode h entered when +21V Is applied to the 
VPP pin. A O.1pF capadtor must be placed across VPP and 
ground to suppress spurious voltage transients which may dam- 
age the device. The address to be programmed is applied to the 
proper address pins. 8-blt patterns are placed on the respective 
data output pins. The voltage levels should be standard TTL 
bvels. When both the address anddata are stable, a SOmsec, 
TTL low level pulse Is applied to the PGM input to accomplish the 
prog-ng. 
The procedure can be done manually, address by address. ran- 
domly, or automatically via the proper circuitry. All that is required 
I8 that orn, 50msec program pulse be applied at each address to 
be programmed. It Is necessary that this program pulse width not 
exceed 55msec. Therefore. applylng a DC low level to the PGM 
input is prohibited when programming. 
READ MODE 


Tho Am2764 has two control functions, both of which must be 
logically stisfied in order to obhn data at the outputs. Chip 
Enable (CE) Is the power ~ n t r o l 
and should be used for device 


sokction. Output Enable (OE! is theoutput control andshould be 
usod 1Q gate data to the output pins. independent of device 
sewon. Assuming that addresses a~stable, address access 
tlme (t~cc) 
Is equal to the delay from CE to output ( E). Data is 


ava,@e at the outputs b. after the faIIIng edge d 4 assuming 
that CE has been low and addresses have been stable for at least 
h - t o E - 


STANDBY MODE 


The Am2764 has a standby mode which reduces the actlve 
power dissipation by 80%. from 525mW to 105mW (values for 
0 to +7(rC). The Am2764 is placed-In 
the standby mode by 
applying a TTL high s~gnal to the CE input. When In standby 
mode. the outputs are In a high impedance state. independent of 
the 0? input. 
OUTPUT OR-TIEING 
To accommodate multiple memory connections, a 2 line control 
function is provided to aHw for: 
1. Low memory power dissipation 
2. Assurance that output bus contention will not occur. 


If k recommended that 
be d w e d and used as the prlmary 


device selecting function, while OE be made a common connec- 
tion to all devices in the array and connected to the READ line 
from the system control bus. This assures that all deselected 
memory device8 are in their low-power standby mode and that 
the output pins are only active when data ka desired from a 
partlcoler mcrmory device. 
PROGRAM INHIBIT 


Programming of multtple Am2764s in p m 2 with different data 
h also e e l y accomplished. Except for WM, all like Inputs (in- 
cluding OE) of the parallel Am2764s may beommon. A Tn 
level program pulse applied 1Q an 141112764's PGM input with VPP 
at 21V will program that Am2764. A hlgh level PGM input lnhib~ts 
the other Am27649 from bJng programmed. 
PROGRAM VERIFY 


A verify should be performed on the programmed bits to deter- 
mtne that they m ~ e 
wrrfily programmed. The verify must be 
performed with GE and CA at VIL. Data should be verified tOE 
after the falling edge of GE. 


SYSTEM APPLlCATlONS 
During the switch between active and standby conditions. trans- 
ient current peaks are produced on the rising and falling edges of 
chip enable. The magnihrde of these transient current peaks 1s 
dependent on the output capacitance loading of the dev~ce 
A O.lpF ceramic capacitor (high frequency. low ~nherent 
inductance) should be used on each devlce between VCC and 
GND to minimize transient effects. In addition, to overcome the 
voltage droop caused by the inductive effects of the pnnted clrcutt 
board traces on EPROM arrays, a 4.7pF bulk electrolytic 
CapaCltOr should be used between VCC and GND for each e~ghl 
devices. The locatlon of the capacitor should be close to where 
the power supply is connected to the array 
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MOS 
LSI 


TMS2532, SMJ2532 


32,768-BIT ERASABLE PROGRAMMABLE READ-ONLY MEMORIES 


DECEMBER 1979 - REVISED SEPTEMBER 198:, 


Organization . . . 4096 X 8 


Single + 5-V Power Supply 


TMS2532 . . J PACKAGE 
SMJ2532 . . J PACKAGE 
(TOP VIEW) 


Pin Compatible with Existing ROMs and 
EPROMs (8K. 16K. 32i.. ~ n d 
64K) 


JEDEC Standard Pinout 


All lnputslOutputs Fully l T L Compatible 


Static Operation (No Clocks, No Refresh) 


Max AccessIMin Cycle Time: 


&Bit Output for Use in Microprocessor- 
Based systems 


N-Channel Silicon-Gate Technology 


3-State Output Buffers 


Low Power Dissipation: 
- Active . . . 400 mW Typical 
- Standby . . . 100 mW Standby 


Guaranteed DC Noise Immunity with 
Standard l T L Loads 


No Pull-Up Resistors Required 


SMJ2532. . . FE PACKAGE 
(TOP VIEW) 


JSP4 Version Available with 168 Hour Burn- 
in and Guaranteed Operating Temperature 


Q1 
0 2 ~ m n n m n m n ~ ~ 
E; 
Range from 0 OC to 85 OC 
1415 1617181920 


(TMS2532 ---JSP4) 
m w m e w m u , 
o Z y o Z o o 


Available in Full Military Temperature Range 
Version (SMJ2532) 


description 


The '2532 serles are 32,768-b~t, ultrav~olet-light- 
erasable, electric#ly-programmable 
read-only 


memories. These dhices are fabricated uslng N- 
channel silicon-gate technology for high speed and 
simple Interface wlth MOS and blpolar clrcults All In- 
puts (~nclud~ng 
program data ~nputs) 
can be dr~ven 
by 


Ser~es 54/74 TTL circuits without the use of external pull-up resistors, and each output can drive one Serles 54/74 
TTL circu~t without external resistors The data outputs are three-state for connecting multiple dev~ces to a common 
bus. The TMS2532 series are plug-~n compat~ble with the TMS4732 32K ROM 


PIN NOMENCLATURE 


A(N1 
Address Inputs 


NC 
No Internal Connect~on 
PDIKM 
Power DownIProgram 


QINI 
Data Outputs 


vCC 
+ 5-v Power Supply 


VPP 
t 25-V Sup~lv 


v~~ 
0-V Ground 


The TMS2532's are offered in a dual-in-line ceramic package (J suffix). rated for operation from O°C to 70°C. The 
SMJ' devices are offered in a 24-pin dual-in-line ceramic package (J) and in a 32-pad leadless ceramic chip carrler 
(FE). The J package is designed for Insertion in mount~ng-hole rows on 15.2 m m (600-mil) centers, whereas the FE 
package is intended for surface mounting on solder pads on 1.27 m m (0.050-inch) centers. The FE package offers 
a three-layer rectangular chip carrier with dimensions 1 1.42 x 13.97 x 2.54 m m (0.450 x 0.550 x 0.100 inches) 
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MOS 
LSI 


TMS2564, SMJ2564 


65,536-BIT ERASABLE PROGRAMMABLE READ-ONLY MEMORIES 


MAv 1981 - REVISED SEPTEMBER 1983 


8 Organization . . . 8192 X 8 


8 Single + 5-V Power Supply 


8 Pin Compatible with Existing ROMs and 


EPROMs (8K. 16K. 32K. and 64K) 


8 All lnput10utputs Fully TTL Compatible 


Static Operation (No Clocks, No Refresh) 


Max AccesslMin Cycle Time: 


TMS2564-35 . . . 350 ns 
TMS2564-45 . . . 450 ns 
SMJ2564-45 . . . 450 ns 


8-Bit Output for Use in Microprocessor- 
Based Systems 


N-Channel Silicon-Gate Technology 


3-State Output Buffers 


Guaranteed DC Nolse Immunity with 
Standard TTL Loads 


No Pull-Up Resistors Required 


' Low Power Dissipation: 
Active . . . 400 mW Typical 
Standby . . . 125 mW Typical 


JSP4 Version Available with 168 Hour Burn- 
in and Guaranteed Operating Temperature 
Range from O°C to 85OC 
(TMS2564 ---JSP4) 


Available in Full Military Temperature Range 
Version (SMJ2564) 


description 


TMS2584 . . J OR JD PACKAGE 


SMJ2564 
J PACKAGE 


(TOP VIEW) 


0 2 


SMJ2564. . . FE PACKAGE 
(TOP VIEW) 


a - i 
-0 


W 
b 
r 
P U N U 
a a ~ m 
> > ~ m > 


'connected ~nternally. VCC need be 


Suppiled to only one of these 
two plns 


The '2564 is a 65,536-b~t ultraviolet-light-erasable, elec- 
trically-programmable read-only memory. This device is 
fabricated using N-channel silicon-gate technology for high- 
speed and simple interface wlth MOS and bipolar circuits 
All inputs lincludlng program data inputs) can be driven by 
Series 5 4 7 4 TTL clrcuits without the use of external 
resistors. The data outputs are three-state for connecting 
multiple devices to a common bus. 


The TMS2564 is offered in a dual-in-line ceramic package 
(J or JD sdffix) rated for operation from O°C to 70°C 
The SMJ2564 is offered In a 28-pin dual-ln-line ceramlc package (J) and a leadless ceramic chip carrler (FE), rated 
for operation from -55OC to 125OC. The J package is deslgned for Insertion in mounting-hole rows on 15,2 mni 
(600-mil) centers, whereas the FE package is intended for surface mounting on solder pads on 1.27 mm (0.050-inchi 
centers. The FE package offers a three-layer rectangular chip carrier w ~ t h 
dimensions 11.43 x 13.97 r 2,54 mm 


(0.450 x0.550 x 0.100 inches). 


PIN NOMENCLATURE 


AIN) 
Address Inputs 


NC 
No Connect~on 


P 
D 
I 
~ 
Power DownIProgram 


Q(NI 
InputIOutput 


S(NI 
~ 
h 
~ 
p 
Selects 


"CC 
+ 5-V Power Supply 


VPP 
+ 25-V Power Supply 
, v~~ 
O-V Ground 


- 
- 
- 


ADVANCE INFORMATION 
6 


Copyr~ght 1 1983 by Texas lristruments Incorporatea 


MILITARY PRODUCTS (SMJI ONLY 


Thls document contains informat~on on a new 
TEXAS 
product. Specifications are subject to change 
without notice 
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MOS 
LSI 


TMS2708, TMS27L08, SMJ2708, SMJ27L08 


1024-WORD BY 8-BIT 
ERASABLE PROGRAMMABLE READ-ONLY MEMORIES 
DECEMBER 1979 - REVISED AUGUST 1983 


1024 X 8 Organization 


All Inputs and Outputs Fully TTL 
Compatible 


Static Operation (No Clocks, No Refresh) 


8 Max AccesslMin Cycle Time 


3-State Outputs for OR-Ties 


8 N-Channel Sillcon-Gate Technology 


&Bit Output for Use In Mlcroprocessor- 
8ased Systems 


TMS2708 
J PACKAGE 


SMJ2708 
J PACKAGE 


(TOP VIEW1 


Power Dissipation 


'27L08 
5B0 mW Max Active 
'2708 
800 mW Max Active 


10% Power Supply Tolerance 
(TMS27L08-45 and all SMJ' versions) 


Plug-Compatible Pin-Outs Allowlng Inter- 
changeabilitylupgrade to 16K With 
Minlmum 8oard Change 


Available in Full Military Temperature Range 
Versions (SMJ2708) 


The '2708-35, '2708-45, 
and '27L08-45 are 
ultraviolet light-erasable, electrically programmable 
read-only memories. They have 8,192 bits organized 
as 1024 words of 8-bit length. The devices are 
fabricated using N-channel sillcon-gate technology for 
high speed and simple interface with MOS and blpolar 
circuits. All inputs (including program data inputs) can 
be driven by Series 54/74 TTL circuits wlthout the use 
of external pull-up resistors. Each output can drive one 
Series 54/74 or 54LS174LS TTL clrcult wlthout ex- 
ternal resistors. The '27L08 guarantees 200 mV dc 
noise immunity in the high state and 250 mV In the 
low state. The data outputs for the '2708-35. 
'2708-45, and '27L08-45 are three-state for 0R.tylng 
multiple devices on a common bus. 


SMJ2708. . . FE PACKAGE 
(TOP VIEW) 


PIN NOMENCLATURE 
AO-A7 
Address Inputs 
NC 
No Connect~on 


PGM 
Program 
01-08 
Data Out 


S(PEI 
Ch~p SelectIProgram Enable 


VBB 
- 5.V Power Supply 


VCC 
+5-V Power Supply 


VDD 
+ 12-\1 Power Supply 


"SS 
0-V Ground 


Copyr~ght 6 1983 by Texas lnrtrurnents Incorporated 
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PRELIMINARY 


ETC 2716 16,384-BIT (2048 x 8) UV Erasable CMOS PROM 


General Description 


ParameterlPart Number 


Access T~me (ns) 


Active Current (mA a 1 MHz1 


Standby Current (mA1 


The ETC 2716 is a high meed 16k UV erasable and electri- 
cally reprogrammable CMOS EPROM ideally sulted for 
applications where fast turn-around, pattern experlmentatlon 
and low power consumption are important reaulrements 


ETC 2716 


450 


5 


0.1 


ETC 27161 


350 


5 


0.1 


The ETC 2716 IS packaged in a 24-pin dual-in-line package 
with transparent lid. The transparent lid allows the user to 
expose the chip to ultraviolet llght to erase the b ~ t 
pattern A 
new pattern can then be wr~tten ~ n t o the dev~ce by follow~ng 
the programming procedure. 


ThisEPROM 1s fabricated with the reliable, hlgh volume, t~me 
proven. P2CMOS slllcon gate technologv 


ETC 2716-5 


560 


5 


0.1 


Features 


ETC 2716-6 


650 


5 


0.1 


CMOS power consumption 
Performance compatible to ETCBOO CMOS 
Microprocessor 


2048 x 8 organization 
Pln compatible to 2716 
Access tlme down to 350 ns 


Slngle 5V power supply 
I 


Statlc . no clocks required 
! I 


lrlputs and outputs TTL cornpatlble dur~ng both read and 
program modes 
Three-state output wlth OR-t~e capablllty 


Block and Connection Diagrams 


VPP 
t 
vcc 
t 
vss 


CONTROLIPROCRAM 


RIPCM -+ 
LOGIC 


AODRtSS 


INPUT 1 


Dual-In-Line Packag 


A6 


I 


I 4 
' 
c 
VCC 


2i A8 
k 
~9 


2 "?P 
26t 


2 
~ 
1 
0 


2 RIPGM 


1 7 - 
01 


06 


I 5 r 
O' 


v s s 


TOIVltW 


Pin Connection During Read or Program 
Pln Names 
I 


I 
I 
1 
AO-A10 
Address Inputs 


I 


Pin NamelNumber 
I 


9-11,13-17 


Read 
VIL 
VIL 
DOUT 


Dl N 
to VIH 


O0-O7 
C ~ ~ P G M 
FE 
VPP 


VCC 
VSS 


Data Outputs 
Chip EnabielProgram 


Output Enable 
Read 5V, Program 25V 
5v 
Ground 


THOMSON SEMICONDUCTORS 
U.S HEADIlUARTERS 
301 Routs 17 North 
RUTHERFORD, NJ 07070 - Tel. (201) 938-2300 


f THOMSON 
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32,768-BIT ERASABLE PROGRAMMABLE READ-ONLY MEMORY 


AUGUST 1 a83 - REVISED SEPTEMBER 1884 


Organization . . . 4096 X 8 
t M 8 2 7 3 ~ 
. . . J PACKAOE 


Single 5-V Power Supply 


All Inputs and Outputs Are TTL Compatible 


Performance Ranges: 


ACCESS TlME 
CYCLE TlME 


(MAX) 
(MINI 


TMS2732A-25 
250 ns 
250 ns 


TMS2732A-30 
300 ns 
300 ns 


TMS2732A-35 
350 ns 
350 ns 


TMS2732A-45 
450 ns 
450 ns 


Low Standby Power Dissipatlon . . . 
158 mW (Maximum) 


JEDEC Approved Pinout . . . Industry 
Standard 


21-V Power Supply Required for 
Programming 


N-Channel Silicon-Gate Technology 


8-8it Output for Use in Microprocessor 
8ased Systems 


A7 
A6 


A 5 
A4 
A3 
A2 
A1 
A0 
Q 1 
02 
03 
GND 


(TOP VIEW) 


PIN NOMENCLATURE 


A0 - A1 1 
Addreaaes 
Chip Enable 
Output Enable121 V 


Q1 - Q8 
O~tputs 
5-V Power Supply 


Static Operation (No Clocks, No Refresh) 


JSP4 Version Available with 168 Hour Bum-in and Guaranteed Operating Tempemtun Rang. from 
0 OC to 85 OC (TMS2732 -,,JSP4) 


Available with MIL-STD-8838 Processing and LIO°C to 70°Ci, El-40°C to 85OC1, or Sl-65OC to 
100°CI Temperature Ranges in the Future 


description 


The TMS2732A is an ultraviolet light-erasable, electrically programmable read-only memory. It has 32,768 
bits organized as 4,096 words of 8-bit length. The TMS2732A only requires a single &volt power supply 
with a tolerance of * 5%. 


The TMS2732A provides two output control lines: Output Enable (c) and Chip Enable (TI). This feature 
allows the 
control line to eliminate bus contention in multibus microprocessor systems. The TMS2732A 


has a power-down mode that reduces msximum power dissipation from 657 mW to 158 mW when the 
device is placed on standby. 


This EPROM is supplied in a 24-pin dual-in-line ceramic package and is designed for operation from O°C 
to 70°C. 


ADVANCE INFORMATION 
Copynght O 1083 by Texas Inrtrummtr Incorporrted 


T ~ ~ t c o n u h . h f ~ r b n m ~ w w p m d u c t 
s#d(k.rbn8 
U. wbkct IO 
C~ 
without M*. 
TEXAS 
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MOS 
LSI 


TMS2764 


65,536-BIT ERASABLE PROGRAMMABLE READ-ONLY MEMORY 


JULY 1983 - REVISED JANUARY 1984 


Organization . . . 81 9 2 X 8 


Single + 5-V Power Supply 


Pin Compatible with TMS2732A EPROM 


All Inputs and Outputs are TTL Compatible 


Performance Ranges: 


MAX ACCESS1 
MIN CYCLE TIME 


TMS2764-20 
200 ns 
TMS2764-25 
250 ns 


TMS2764-30 
300 ns 


TMS2764-35 
350 ns 
TMS2764-45 
450 ns 


Low Active Current . . . 100 mA (Max) 


JEDEC Approved Pinout 


21-V Power Supply Required for 
Programming 


Fast Programming Algorithm 


N-Channel Silicon-Gate Technology 


&Bit Output for Use in Microprocessor- 
Based Systems 


Static Operation (No Clocks, No Refresh 


JSP4 Version Available with 168 Hour Burn- 
in and Guaranteed Operating Temperature 
Range from O°C to 85OC 
(TMS2764---JSP4) 


TMS2764 . . . J PACKAGE 


(TOP VIEW) 


1 
PIN NOMENCLATURE 
AO-A1 2 
Addresses 
- 
E 
Chip Enable 


6 
Output Enable 
GND 
Ground 
NC - 
No Connect~on 


PGM 
Program 
01-08 
outputs 


Vcc 
+ 5-V Power Supply 


VPP 
+ 21-V Power Supply 


Available with MIL-STD-8838 Processing 
and L(O°C to 70°C), E( -40°C to 85OC). or 
M( - 55 OC to 125 OC) Temperature Ranges 
in the Future 


description 


The TMS2764 IS an ultraviolet light-erasable, electrically programmable read-only memory. it has 65,536 bits organ~zed 
as 8.1 92 words of &bit length. The TMS2764-20 only requires a single 5-volt power supply with a tolerance of +- 5%, 
and has a maximum access time of 200 ns. This access time IS compatible with high-performance microprocessors 
\ 


The TMS2764 provides two output control lines: Output Enable (G) 
and Chip Enable (F). 
This feature allows the G 


control line to eliminate bus contention in microprocessor systems. The TMS2764 has a power-down mode that reduces 
maximum active current from 100 mA to 35 mA when the device is placed on standby. 


This EPROM is supplied in a 28-pln, 15.2 mm (600-mil) dual-in-line ceramic package and IS designed for operation 
from O°C to 70°C. 


Copvrlght ic\ 1984 by Texas Instruments Incorporatt., 


ADVANCE INFORMATION 


Thb documant cmuha informath m a now moduct 
Sp.cMcaCbns aro aubjoct to clung* without notke 
TEXAS 
INSTRUMENTS 


POST OFFICE BOX 1443 
nOuSrOk TEXAS 77001 
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Advanced 128K (16 x 8) UV Erasable PROM 


Fast 150 nsec Access Time 
- 
HMOS* Il-E Technology 


Low Power 
- 
100 mA Maxlmum Active 
- 
40 mA Maxlmum Standby 


w Two Llne Control 


lnteligent ProgrammingTM Algorithm 
- 
Fastest EPROM Programming 


Intellgent ldentif ierTM Mode 
- 
Automated Programming Operations 


Compatible with 2764A, 27128, 27256 
f 10% VCC Tolerance Available 


The lntel 271 28A is a 5V only, 131,072-bit ultraviolet erasable and electrically programmable read-only memo- 
ry (EPROM). The 27128A is an advanced version of the 27128 and is fabricated with Intel's HMOSII-E 
technology which significantly reduces die size and greatly improves the device's performance, reliability and 
manufacturability. 


The 27128A is available in fast access times including 200 ns (27128A-2) and 150 ns (27128A-1). Th~s 
ensures compatibility with high-performance microprocessors, such as Intel's 8 MHz iAPX 186 allowing full 
speed operation without the addition of WAIT states. The 27128A is also directly compatible with the 12 MHz 
8051 family. 


Several advanced features have been designed into the 271 28A that allow fast and reliable programming-the 
inkligent Programming Algorithm and the inkligent Identifier Mode. Programming equipment that takes ad- 
vantage of these innovations will electronically identify the 27128A and then rapidly program it using an 
efficient programming method. 


Two-line control and JEDEGapproved, 28 pin packaging are standard features of all lntel higher dens~ty 
EPROMs. This ensures easy microprocessor interfacing and minimum design efforts when upgrading, addlng 
or choosing between non-volatile memory alternatives. 


'HMOS is 8 patented process of lntel Corporat~on 


230849- 1 


Flgure 1. Block Dlagram 


Mode Selection 


230849-2 


NOTE: lntel "Un~versal S~te"-Compat~ble 
EPROM Pin Configurat~ons 


are Shown In the Biocks Adlacent to the 27128A P~ns 
Figure 2. Pin Configurations 


27258 


VPP 


A12 
A7 


As 


A3 


A2 
A1 


Do 
0, 


0 2 
Gnd 


Pin Names 


- 


2716 


VE 


A 
¶ 
& 


Ae 
Voo 
m 


2732A 


A7 


A5 


A3 


A2 
A1 


0 0 
0 1 


0 2 
Gnd 


2764A 


VPP 


A12 
A7 


* 
s 
* 
s 
* 
s 
* 
s 


A5 


A 
4 
4 
4 
4 


A3 


A2 
A1 


b 
b 
b 
b 


0, 
0 1 


0 2 
Gnd 


CHIP ENABLE 
OUTPUT ENABLE 


PROGRAM 


2764A 


vcc 
m 
N C 


A¶ 


As 
A 
UE 


2732A 


Vcc 


Ae 
A > > 
UEIVpp 


2716 


A7 


A5 


A3 
A2 
A1 


0, 
Dl 


0 2 
Gnd 


1. X c m ~ ~ V I H O C V I ~ 
2 VH=~~OV=O.SV 


lntel Corporation assumes no respons~b~l~ty 
for the use of any c~rcuttry other than clrcuttry embodled in an lntel product. No other circu~t patent 


licenses are implied. Infonabon contained here~n supersedes prev~ously publ~shed speclf~catlons on these devlces from Intel. 
Apdl 1984 


@ lntel Corporation, 1984. 
Order Number: 230849402 


27256 


vcc 
A,, 
! 


AII 
I 


Aa 


Au 
A,, 
I 


UE 
I 


E 
E 
E 
E 
l 
07 
0 7 
0 7 
0 
7 


0 5 
05 
0 5 
0 5 
1 
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0, 
0 3 0 3 


04 
0, 
03 


0 4 


0 3 


VT27C256 PRELIMINARY 
32,768 x 8 STATIC CMOS EPROM 


FEATURES 


32,768 x 8-bit organlzatlon 
Current-Operating: 80 mA max 
Standby. 200 pA max 


Total static operation 
Automatic power down (a) 
Complete 1TL compatibility 
3-state outputs for wired-OR 
expansion 
28-pin JEDEC approved pinout 


DESCRIPTION 
The m27C256 high-performance 
CMOS Erasable Programmable 
Read Only Memory is organized as 
32,768 bytes and has an access 
time of 200 ns It is compatible with 
all microprocessors and s~m~lar 
high- 


performance applicat~ons where 
high-density storage reprogramma- 
bility and simple ~nterfacing 
are 


~mportant 
design considerations 
The V127C256 has automatic power- 
* Programming-Voltage. + 12V 
down which 1s controlled by the 


Current. 30 mA 
Chip Enable (G) lnput When a 


goes HIGH, the dev~ce automati- 
cally powers down and remains In 
a low-power standby mode. This 
unique feature prov~des substant~al 
systems-level power savings An- 
other functlon of the Vl27C256 1s the 
Output Enable (m) 
wh~ch ellmlnates 


bus content~on 
The Vl27C256 IS manufactured wl+h 
Vll's advanced high-performance 
HCMOS crocess and 1s ava~lable 
In 


a JEDEC-standard 28-pin dual ~n-llne 
package 


PIN CONFIGURATIONS 
BLOCK DIAGRAM 


ROW 
DECODER 
DRIVER 
(t OF.512) 


262.1u 


EPROM AREA 


I512 x 512) 


POWER DOWN 
CIRCUITRY 
6E 


PROGRAMMING 
OUTPUT ENABLE 


LOQlC 


VLSl Technology Inc 
1109 McKay Dr~ve Son Jose. CA 94131 408-942-1810 
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. 
27512 
512K (64K x 8) UV ERASABLE PROM 


Software Carrier Capability 
Industry Standard Pinout . . . JEDEC 


250 ns Standard Access Time 
Approved 


Tkro-Line Control 
Low Power 
- 125 mA max. Active 


inbligent IdentifierT" Mode 
- 40 mA max. Standby 
- 
Automated Programming Operations 
inbligent ProgrammingT" Algorithm 


8 TTL Compatible 
- Fastest EPROM Programming 


The lntel 27512 is a 5V only. 524, 288 b ~ t 
ultraviolet Erasable and Electrically Programmable Read Only 


Memory (EPROM). Organized as 64K words by 8 b~ts, 
lnd~vldual bytes are accessed In under 250ns Th:s 


ensurescompatibility with hlgh performance microprocessors, such as the lntel 8MHz IAPX 186, allowlng ~LIII 
speed operation without the addltion of performance-degrad~ng WAIT states The 27512 IS also directly 
compatible with Intel's 8051 famlly of microcontrollers 


The 27512 enables implementation of new, advanced systems with flrmware intenslve architectures The 
combination of the 27512's high dens~ty, cost effectlve EPROM storage, and new advanced microprocessors 
havlng megabyte addressing capability provldes designers with opportunities to englneer userfrtendly, high 
reliability, high-performance systems 


The 27512's large storage capablllty of 64K bytes enables ~t to funct~on as a hlgh denslty software carrier 
Entire operating systems, diagnost~cs, h~gh-level language programs and spec~alized appllcat~on software 
can reside in a 27512 EPROM dlrectly on a system's memory bus. Thls permits ~mmed~ate 
microprocessor 


access and execution of software and elim~nates the need for time consuming disk accessesand downloads 


Two advanced features have been designed Into the 27512 that allow for fast and rellable programming - the 
inteligent identifier'" mode and the Intellgent Programm~ng" Algorithm Programming equipment that takes 
advantage of these innovations will electronically Identify the 27512 and then rapidly program ~t using an 
efficient programmlng method 


Two-line control and JEDEC-approved, 28-pin packaging are standard features of all lntel h~gh-density 
EPROMs. This assures easy microprocessor Interfacing and mlnimum deslgn efforts when upgrading, 
adding, or choosing between nonvolatile memory alternatives. 


The 27512 is manufactured using Intel's advanced HMOs '11-E technology. 


'HMOs IS a patented process of lntel Corporat~on 


vcc - 
GND - 


DATA OUTPUTS 
00-07 - 


VPP 
PROGRAM 
AND 
a! 
i% 
LOGIC 
OUTPUT BUFFERS 


-15 


ADDRESS 
INPUTS 


Y 


DECODER 4 
Y-GATING 


X 
DECODER . 
524.288 


CELL MATRIX 


Figure 1: Block Diagram 


. . 


Oo-O7 
1 OUTPUTS 


PIN NAFES 


Figure 2. Pin Configuration 


AO-A15 


CE 


bTf/vpp 


Intel Cor~oratlon 
Assumes No Responstb~l~ty 
for the Use of Any C~rcu~try 
Other Than C ~ r c u ~ t r y 
Embodled In an lnlel Producl No Other C i r c u ~ t 


Patent Llcenses are lmpl~ed 


ADDHESSES 


CHIP ENABLE 
OUTPUT ENABLE/Vpp 


O INTEL CORPORATION. 19& 
MAY 1984 
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64K-BIT UV ERASABLE PROM 


The MCM68764 is a 65,536-bit Erasable and Electrically Reprogram- 


mable PROM des~gned for systev debug usage and similar applications 
requlrlng nonvolat~le memory that could be reprogrammed per~odically, 
or for replac~ng 64K ROMs for fast turnaround time The transparent 
window on the package allows the memory content to be erased with 
ultrav~olet light 
For ease of use, the device operates from a slngle power supply and 
has a static power-down mode Pin-for-pin mask programmable ROMs 
are available for large volume production runs of systems ~n~tially 
uslng 


the MCM68764 


S~ngle + 5 V Power Supply 
Automatic Power-down Mode (Standby) w ~ t h 
Chip Enable 


Organized as 8192 Bytes of 8 Bits 
Power Diss~pation 


120 mA Act~ve Maximum 
25 mA Standby Mawmum 


Fully TTL Compatible 
Maximum Access Time = 450 ns MCM68764 


350 ns MCM68764-35 


Standard 24-Pin DIP for EPROM Upgradability 
Pin Com~atible to MCM68A364 Mask Programmable ROM 


MOS 


(N-CHANNEL, SILICON-GATE) 
8192 x &BIT 


UV ERASABLE 
PROGRAMMABLE READ 
ONLY MEMORY 


FRIT.SEAL CERAMIC PACKAGE 


I I 
MOTOROLA'S PIN-COMPATIBLE EPROM FAMILY 


MOTOROLA'S PIN-COMPATIBLE ROM FAMILY 


1 
INDUSTRY STANDARD PINOUTS 
A 
A 
~ 
2 
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PIN ASSIGNMENT 


Address 
- 
Data InputtOutput 
E/Vpp 
Chip EnableIProgram 


P A G E 1 5 1 


Advance Information 
I 


8192x &BIT UV ERASABLE PROM 


The MCM68766 is a 65,536-b~t Erasable and Electr~cally Reprogram- 


mable PROM deslgned for system debug usage and slmllar appl~cat~ons 
requ~ring nonvolat~le memory that could be reprogrammed per~od~cally, 
or for replacing 64K ROMs for fast turnaround tlme The transparent 
window on the package allows the memory content to be erased wtth 
ultrav~olet l~ght 


For ease of use. the device operates from a single power supply that 
has an output enable control and 1s pln-for-p~n compat~ble with the 
MCM68366 mask programmable ROMs, wh~ch are ava~lable for large 
volume production runs of systems ~n~tlally 
using the MCM68766 


S~ngle + 5 V Power Supply 
Organ~zed as 8192 Bytes of 8 B~ts 
Fully TTL Compat~ble 
Max~mum Access T~me 
= 450 ns MCM68766 


350 ns MCM68766-35 


Standard 24-PI~ DIP for EPROM Upgradab~l~ty 
Pln Compat~ble to MCM68366 Mask Programmable ROM 
Power D~ssipat~on - 160 mA Max~mum 


MOTOROLA'S PIN-COMPAT IBLE EPROM FAMILY 


MOTOROLA'S PIN-COMPATIBLE ROM FAMILY 


INDUSTRY STANDARD PINQUT S 
-1 
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MOS 


(N-CHANNEL, SILICON-GATE) 


8192 x &BIT 


UV ERASABLE 
PROGRAMMABLE READ ONLY 
MEMORY 


4 


C SUFFIX 


- * 
FRIT-SEAL CERAMIC PACKAGE 


PIN ASSIGNMENT 


.Data In~uttOut~ut 


€ 
1 
~ 
~ 
~ 
Output Enable1 Program 


'New ~ndustry standard nomenclature 
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WHAT ADVANTAGES DO EPROM's 
..- 
HAVE? 


The attraction of the EPROM is its extreme usefulness in prototyping software codes in mlcroprocessor designs. It 
typically takes several "passes" through a system before a program's code can be correct and optimized. Each 
"pass" requires a new program and a ROM that can be erased and reprogrammed quickly makes it much easier to 
optimize a program. For a complex project, UV-erasable PROM's can save months of trial-and-error programmlng. 


An additional dimension of flexibility has been added to systems design because, even when the programmer is 
satisfied with the program, it can be changed at a later date to accommodate new systems features. Alternatively, 
the user can switch to mask-programmed ROM's or can program ROM's with identical pin assignments and power 
supply requirements. 


In practice EPROM's are being increasingly designed as a permanent part of a system because of the severe price war 
that has resulted in prices that make them very competitive with the less flexible, non-erasable PROM's and ROM's 
Lengthy turnarouna tlmes for custom-programmed circuits are avoided and they are now appearing in many 
upanticipated snlall volume production applications (even though they may never be programmed again), as well as 
for prototyping. Once the right program has been found, other UV-erasable PROM's may be programmed to duplicate 
the bit pattern of the prototype. 


Ultimately, ROM's manufactured from specific masks to duplicate the bit pattern would be substituted for large 
production runs. In the latter case, the experimental EPROM would then be erased and moved to another 
experimental location. 


HOW DO EPROM'S WORK? 


The basic memory element was developed by Frohman-Bentchkowsky at Intel Corporation and was known as the 
Floating.Gate-Avalanche~lnjection MOS (FAMOS) transistor. It was essentially a silicon gate MOS field effect 
transistor in wnich no connection was made to the gate. The gate was in fact electrically "floating" in an insulating 
layer of silicon dioxide. The devices have been fabricated in two structures: p-channel or n-channel. The p-channel 
devices were the first EPROM's available commercially, but many devices are now using n-channel technology. N- 
channel MOS devices have the advantage of being able to function with a single power supply. 


By application of a sufficiently large potential difference between the source and drain, charge can be injected into 
the "floating" gate which induces a charge in the substrate. The source-to-drain impedance changes and a "p. 
channel" or "n-channel" is created, depending upon the type of substrate. The presence or absence of conduction is 
the principle of data storage. Application of short wave (254nm) ultraviolet light causes the gate charge to leak away 
and restores the device to its original unprogrammed state. 


WHAT IS ULTRAVIOLET LIGHT? 


Ultraviolet light is an invisible band of radiation beyond the violet end of the electromagnetic spectrum It extends 
from a wavelength of 0 1 to about 380nm (nanometers), although the region between 180 and 380nm is the only part 
that is normally experienced because of the absorption of shorter wavelengths by air The wavelength of speciflc 
interest in the UV-EPROM application is 253.7nm, which is usually rounded off to 254nm. 


HOW MUCH ULTRAVIOLET LIGHT IS NEEDED FOR ERASURE? 


The time requlred for complete erasure of tne information on a cell 1s very consistent from device to devlce, provided 
that the fused silica w~ndow 1s clean and there are no pieces of dirt, grease or silicon fragments on the surface of the 
EPROM. In these cases the shadows reduce the amount of ultrav~olet light falling on those cells obscured by the 
obstacle, thus Increas~ng the time requ~red for complete erasure, Awareness of the problems, and screening followed 
by careful cleaning of the fused sllica window, can minimize the required erase times. For maximum irradiance at the 
chip, the tube or grid of the eraser should also be kept clean of grease and other ultraviolet-absorbing materials by 
periodically wiping it down wlth asolvent such as alcohol. 


Most EPROM chip manufacturers have asslgned nominal erasing energies to their devices to assist the user in 
determining the optimum erase time. Manufacturers usually specify an erasing energy of 15W-seclcm2, although 
many EPROM's require only 10 or even 6W-seclcm2 for complete erasure 


The manufacturer's recommended eraslng time in seconds is Obtained by multiplying the nominal eraslng energy 
(W-seclcm2) by 1,000,000 and dividing by the ultraviolet irradiance at the chip (in microwattslcm2). 


Nominal Erasing Energy (W-seclcm2) x 1,000,000 
Time (secs) = 
lrradiance (pWlcm2) 
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SIMULTANEOUS ERASING OF SEVERAL EPROM's 


The published erasure times given by some manufacturers of EPROM erasers are optlmum times based on the ideal 
situation of one chip at the point of maximum irradiance. Because of the inadequate explanation of this fact, some 
confusion has arisen when simultaneously erasing several EPROM's, and incomplete erasure of one or more chips 
has occurred, The programmer has been uncertain as to whether the eraser was functioning incorrectly or that 
perhaps the chips were bad. There could be an alternative explanation and ~t is the purpose of this bulletin to explore 
the situation when erasing several EPROM's simultaneously. 


The irradiance produced at the surface of the EPROM chip is dependent upon where it is located with respect to the 
tubeof the eraser. For example, if it is located off to the side and near to the end of the tube it receives considerably 
less UV irradiance than a c h ~ p 
located directly below the center of the tube Usually this latter location 1s that chosen 
by lamp manufacturers when specifying erasure times However, these figures are usually meaningless if the eraser 
is loaded with more than one EPROM, because obviously only one chip can recelve the maximum irradiance. The 
parameter is the time neeaea for eraslng all of the EPROM's - Including the worst placed EPROM (1.e the chlp recelv- 
ing the least amount of 254nm energy per unit time) 


The following table provides data concerning estimated eraslng times for the 
favorably situated chip In each of 
the ten Spectrolinem EPROM erasers' 


ERASING TIME REQUIRED, IN MINUTES 


Ir.lPORTANT: The above erasing times are based upon typical peak irradiances of the erasers and are given only as 
estimates - actual erasing times may vary. The suggested operating procedure is to use the above table to select the 
estimated erasing time and then vary the exposure period until you determine the minimum amount of time required 
for complete erasure. 


NOMINAL 


ERASINGENERGY 
' 6W-seclcm2 


10W-seclcm2 
15W-seclcm2 


As with all metal vapor discharge lamps, the output of the ultraviolet tubes and grids in our EPROM erasers will 
gradually decrease throughout their life. Due to the general unpredictability of the rate of UV intensity decline, 
clrmlrlatlve hour recorders in EPROM erasers cannot accurately indicate tube life. Use of a snort wave UV rad~ometer 
is thus the most effective way of determining proper erasure time and monitoring the useful life of the ultraviolet light 
source. The Spectro1inem DM-254X Meter is recommended for measuring UV intensity, while the DS-254E 
EPROMETERTM not only measures UV intenslty but also calculates the time needed for complete erasure. Please 
contact the factory for complete information. 


DOES THE EPROM WEAR OUT? 


It has been noticed that repeated erasing and reprogramming of EPROM's appears to increase the required erasing 
tlme. Not much has been published regarding this phenomenon because EPROM's are usually not cycled that large a 
number of times-it can only be speculated that possibly some chemical changes take place within the device. The 
one thing that is certain is that it is dependent upon the eraslng and programming techniques. Well over 100 
programming and erase cycles still resulting in a usable EPROM have been reported in Ilterature (1) uslng certain 
programming technlques and equipment, yet some reports have indicated only 30 to 50 t~mes using other technlques. 


+ 


PC i 
loo PC-2200 
PC-3300. ~c.4400 


1 CHIP 


TO FULL 
CAPACITY 


5.4 
9 0 
13.5 


- - 


Attempts have been made to "recondition" the devlces by baking them prlor to erasing-this techn~que has resulted 
in some reduction in tne erase time. However, no method has gained widespread acceptance or recommendat~on 
because of its very limited need 


r 


PE.14, PE-14T 


CAUTION 
All SpectrolineB EPROM erasing lamps and cablnets are provlded w ~ t h 
a safety Interlock 
mechanism to protect against accidental exposure of eyes or skin to hazardous short wave ultra- 
violet light. Operation of the eraser 1s prevented unless the tray or drawer IS fully and properly 
inserted into the housing. Any attempt to defeat the safety Interlock may result In pa~nful 
eye 


andlor sk~n 
burns or other harmful effects 


-..-----.---.---p-------.----- 
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9 
EPROM 
CHlPS 
15.3 
25.6 
38.4 


PE-24T 


1 
EPROM 
CHlP 


12.5 
20.8 
31.2 


2 
EPROM 
CHIPS 


10.4 
17.4 
26 0 
- - 


3 
EPROM 
CHlPS 
13.8 
22.9 
34 5 
- - 


PR- 1 25T, 
PR-320T 


1 CHIP 


TO FULL 
CAPACITY 


5.9 
9.8 
14.7 
- 


PL-265T 


4 
EPROM 
CHIPS 


10 9 
18.1 
27 2 


2 
EPROM 
CHIPS 


10 4 
17.4 
26 0 
- -- 


12 
EPROM 
CHlPS 


13 6 
22 7 
34.1 


5 
EPROM 
CHlPS 


10.9 
18.1 
27 2 


30 
EPROM 
CHIPS 


13.6 
22.7 
34.1 


COPYRIGHT N O T I C E 


EPROM PROGRAMMERS HANDBOOK 
C O P Y R I G H T 1985 ( C ) B Y CSM SOFTWARE I N C 
A L L R I G H T S R E S E R V E D 


T h i s manual and t h e computer programs on t h e accompanying 
f l o p p y 
d i s k s , which a r e d e s c r i b e d by t h i s manual, 
a r e 
c o p y r i g h t e d 
a'nd 
c o n t a i n p r o p r i e t a r y i n f o r m a t i o n b e l o n g i n g t o CSM SOFTWARE I N C . 


No one may g i v e o r s e l l c o p i e s of t h i s manual o r t h e accompanying 
d i s k s o r of t h e l i s t i n g s of t h e programs 
on 
t h e 
d i s k s 
t o 
any 
person o r i n s t i t u t i o n , e x c e p t a s 
p r o v i d e d 
f o r 
by 
t h e 
w r i t t e n 
agreement w i t h CSM#.rSOFTWARE I N C . 


*Y 


No one may copy, photocopy, r e p r o d u c e , t r a n s l a t e t h i s manual 
o r 
r e d u c e i t t o machine r e a d a b l e form, i n whole o r i n p a r t , 
w i t h o u t 
t h e p r i o r w r i t t e n c o n s e n t of CSM SOFTWARE I N C . 


WARRANTY AND L I A B I L I T Y 


N e i t h e r CSM SOFTWARE I N C . , 
nor any d e a l e r 
o r 
d i s t r i b u t o r 
makes 
any w a r r a n t y , e x p r e s s o r i m p l i e d , w i t h r e s p e c t 
t o t h i s 
manual, 
t h e 
d i s k 
o r 
any 
r e l a t e d 
i t e m , 
t h e i r 
q u a l i t y , 
performance, 
m e r c h a n t a b i l i t y , 
o r 
f i t n e s s f o r 
any 
purpose. 
I t 
i s 
t h e 
r e s p o n s i b i 1 i t y 
s o l e l y 
of 
t h e 
p u r c h a s e r 
t o 
d e t e r m i n e 
t h e 
s u i t a b i l i t y of t h e s e p r o d u c t s f o r any purpose. 


- 
I n no c a s e w i l l CSM SOFTWARE I N C . 
be 
h e l d 
l i a b l e f o r 
d i r e c t , 
i n d i r e c t o r i n c i d e n t i a l damages 
r e s u l t i n g 
from 
any 
d e f e c t 
o r 
omission i n t h e manual, t h e 
d i s k 
o r 
o t h e r 
r e l a t e d 
i t e m s 
and 
p r o c e s s e s , i n c l u d i n g , b u t n o t l i m i t e d 
t o , 
any 
i n t e r r u p t i o n 
of 
s e r v i c e , 
1 o s s 
of 
b u s i n e s s , 
a n t i c i p a t e d 
p r o f i t , 
o r 
o t h e r 
c o n s e q u e n t i a1 damages. 


T H I S S T A T E M E N T OF L I M I T E D L I A B I L I T Y 
I S 
I N 
L I E U 
OF 
A L L 
OTHER 
W A R R A N T I E S , 
E X P R E S S 
OR 
I M P L I E D , 
I N C L U D I N G 
W A R R A N T I E S 
OF 
M E R C H A N T A B I L I T Y 
AND 
F I T N E S S 
FOR 
A 
P A R T I C U L A R 
PURPOSE. 
CSM SOFTWARE I N C . 
w i l l 
n o t 
assume 
any 
o t h e r 
w a r r a n t y 
o r 
l i a b i l i t y . Nor do t h e y a u t h o r i z e any o t h e r person t o 
assume 
any 
o t h e r w a r r a n t y o r l i a b i l i t y f o r them, i n c o n n e c t i o n w i t h t h e s a l e 
of t h e i r p r o d u c t s . 


UPDATES AND R E V I S I O N S 


CSM SOFTWARE I N C . r e s e r v e s t h e r i g h t t o c o r r e c t 
a n d / o r 
improve 
t h i s manual and t h e r e l a t e d d i s k a t any t i m e w i t h o u t 
n o t i c e 
and 
w i t h o u t 
r e s p o n s i b i l i t y 
t o 
p r o v i d e 
t h e s e 
changes 
t o 
p r i o r 
p u r c h a s e r s of t h e program. 


IMPORTANT N O T I C E 


T H I S PRODUCT I S S O L D S O L E L Y FOR T H E E N T E R T A I N M E N T 
AND 
E D U C A T I O N 
OF T H E PURCHASER. 
I T I S I L L E G A L TO S E L L OR D I S T R I B U T E 
C O P I E S 
OF 
C O P Y R I G H T E D PROGRAMS. 
T H I S 
PRODUCT 
DOES 
NOT 
CONDONE 
SOFTWARE 
P I R A C Y NOR DOES I T CONDONE ANY OTHER I L L E G A L A C T . 


